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Preface 


LSENS, the Lewis General Chemical Kinetics and Sensitivity Analysis Code, has been 
developed for homogeneous, gas-phase chemical kinetics computations and contains sen- 
sitivity analysis for a variety of problems, including nonisothermal situations. The code is 
described in a series of three reference publications, which also provide a detailed guide 
to its use and many illustrative test problems. 

LSENS has been designed for accuracy, efficiency, flexibility, and convenience. A 
variety of chemical reaction models can be considered: static system; steady, one- 
dimensional, inviscid flow; reaction behind an incident shock wave, including boundary 
layer correction; and perfectly stirred (highly backmixed) reactor. In addition, the chemi- 
cal equilibrium state can be computed for the assigned states of temperature and pressure, 
enthalpy and pressure, temperature and volume, and internal energy and volume. Any 
reaction problem can be adiabatic, have an assigned heat transfer profile, or for static and 
flow problems, have an assigned-temperature profile. For static problems either the den- 
sity is constant or the pressure-versus-time profile is assigned. For flow problems either 
the pressure or area can be assigned as a function of time or distance. For a static reaction 
sensitivity coefficients of the dependent variables and their temporal derivatives with re- 
spect to the initial values of the dependent variables and/or the three rate coefficient pa- 
rameters of the chemical reactions can be obtained. 

LSENS checks the legality and sufficiency of all input. At the user’s option LSENS 
checks the reaction mechanism for uniqueness and ensures that each reaction satisfies 
charge and atom balance requirements. 

Part I of the series (NASA RP-1328), consisting of chapters 1 to 7, presents the theory 
and the numerical solution procedures used in LSENS. The ordinary differential equations 
(ODE’s) describing chemical kinetics problems are derived in chapter 2. Chapter 3 de- 
scribes the numerical integration method and how it is implemented. In chapter 4 the gov- 
erning ODE’s for sensitivity analysis are derived and the solution method and numerical 
algorithm explained. The governing equations and solution methods for the chemical equi- 
librium state, equilibrium and frozen thermodynamic states behind an incident shock 
wave, and perfectly stirred reactor problems are presented in chapters 5 to J. 

This volume, part II of the series (chapters 8 to 13 and appendixes A to C), describes 
LSENS, its usage, and how to modify it. Chapter 8 describes the computational capabili- 
ties and convenience features built into the code. Chapter 9 presents its structure and de- 
scription. Chapter 10 lists modifications that may be required to implement LSENS on the 
user’s computer system. Chapter 1 1 provides a guide to code usage and describes how to 
prepare the input data files required to execute LSENS. The output information generated 
by the code is discussed in chapter 12. Example problems illustrating both problem data 
file construction and code usage are given in chapter 13. These examples supplement 
chapter 1 1 by providing additional guidance on preparation of the problem data file. 
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The partial derivatives required by the numerical solution procedures detailed in chap- 
ters 3, 4, and 7 are derived in appendix A. Appendix B shows how to access the system 
clock for several common computing systems so that execution times can be measured. 
Appendix C describes the modifications required to change the built-in values for various 
quantities. 

Part III of the series (NASA RP-1330), consisting of appendixes D and E, explains the 
example problems provided with LSENS and presents sample results. Appendix D de- 
scribes the kinetics test cases. These problems illustrate the various reaction models that 
can be solved by, and options built into, LSENS. Appendix E describes the kinetics-plus- 
sensitivity-analysis test cases supplied with the code. The examples in the two appendixes 
cover a variety of problem types and so should serve as useful models for the structure of 
the problem data file required to execute the code. Indeed, it is likely that the desired file 
can be produced by modifying one of the test cases. 

Details regarding code availability and procurement can be obtained from COSMIC, 
328 East Broad Street, University of Georgia, Athens, GA 30602 (Telephone: 706-542-3265). 
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Sij sensitivity coefficient of ith dependent variable with respect to yth 

sensitivity parameter or Sutherland interaction constant for species i 
and j, equation (8.44) 

(S^) normalized sensitivity coefficient of ith dependent variable with respect 

to j th sensitivity parameter 

S m sum of mass fractions of all species, equation (12.1 1) 

£y sensitivity coefficient vector with respect to 7th sensitivity parameter 

fii chemical symbol for species i 

S\ defined by equation (A34) or (A39) 

S 2 defined by equation (A35) 

5 mass-specific entropy of mixture 

S j molar-specific entropy of species i 

T temperature 

Ain T logarithmic correction of temperature for assigned-mass-flow-rate PSR 

calculation 

T e q equilibrium temperature 

T w wall temperature 

TCONST logical variable defined within code and indicates whether temperature is 
constant 

TCPU total CPU time for problem 

TOUT next value of independent variable at which solution to ODE’s is required 

t time 

u mass-specific internal energy of mixture 

V flow velocity 
volume 

V mass-specific volume of mixture 

Wj net molar production rate per unit volume of species i, equation (12.8) 

Xh total energy exchange rate, equation (12.9) 

Xfjj net energy exchange rate for reaction j, equation (12.13) 
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Symbols 

X 




Xi 

Yi 

X 


yi 


yt 

Zj(k) 

Zj 


z 


p 

Po 

r 

7 

T| 


n j 

K 

Kj 

A, A, 


V 


Vi 


V/, V/' 


v«. v </ 


net reaction conversion rate for reaction j, equation (8.56) 
distance 

mole fraction of species i 

mole fraction of species i in oxidant 

ith component of X 

numerical solution vector to chemical kinetics ODE’s 

exact solution of ith dependent variable for chemical kinetics problems or 
mass fraction of species i 

mass fraction of species i in oxidant 

kt h column of Z j 

Nordsieck history matrix for sensitivity coefficients with respect toyth 
sensitivity parameter 

Nordsieck history matrix for solution to chemical kinetics problem 

shock tube boundary layer thickness parameter 

integration method coefficient (see eq. (9.3)) 

quantity defined by equation (12.22) 

frozen specific heat ratio of mixture, equation (12.4) 

Kronecker symbol, equation (A 150) 

exponent in equations (9.4) and (9.5) for shock tube flow area and 
characteristic length 

yth sensitivity parameter 

thermal conductivity of mixture 

thermal conductivity of species i 

underrelaxation factors used in controlling magnitude of corrections in 
PSR computation 

dynamic viscosity of mixture 

dynamic viscosity of species i 

stoichiometric coefficients of reactant and product species i in 
reactions (8.1) and (8.2) 

stoichiometric coefficients of reactant and product species i in 
reaction j 
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Symbols 

£ “integration variable” (i.e., independent variable for chemical kinetics 

ODE’s) — time or distance 

independent variable (time or distance) for assigned-variable (pressure or 
area) profile 

^7 independent variable (time or distance) for temperature profile 

p mixture mass density 

CJ/ mole number of species i — moles of species i per unit mass of 

mixture 

Ain a, logarithmic correction of mole number of species i for PSR calculation 

<5 m sum of mole numbers of species, equation (12.23) 

T r average residence time for PSR 

(p fuel-oxidant equivalence ratio 

4 )y interaction term used to calculate mixture dynamic viscosity, 

equation (8.40) 

<j> f y interaction term used to calculate mixture thermal conductivity, 

equation (8.42) 

X quantity defined by equation (A32) 

Q cranking angular velocity of Otto-cycle engine, equation (8.31) 

a net molar formation rate of species i per unit volume by reaction j, 
equation (8.58) 

Subscripts: 
air 

/ 

N 
NR 
NT 
NV 
n 

out 


xxiii 


oxidant 

fuel 

index for either temperature or mass flow rate in PSR calculation 
index for density derivative in chemical kinetics calculation 
index for temperature derivative in chemical kinetics calculation 
index for velocity derivative in chemical kinetics calculation 
value at 

value at next output station 

stoichiometric 

standard conditions (1 atm) 


st 



Symbols 

0 


initial condition value 


1 condition upstream of incident shock wave or assigned value for first 
solution of PSR problem 

2 condition downstream of incident shock wave 
Superscripts: 

(j) jth derivative 

[i m ] value at mth iteration 

[0] predicted value 

° standard state (1 atm) 

* value at perfectly stirred reactor inlet 
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Chapter 8 

Capabilities of Code 

The LSENS code has been designed for the following 
reaction models and computations: 

(1) Static reaction either at constant density or with as- 
signed pressure 

(2) One-dimensional flow reaction with an assigned pres- 
sure or area profile 

(3) Static or flow reaction with an assigned temperature 
profile 

(4) Sensitivity analysis for a static reaction 

(5) Equilibrium reaction 

(6) Reaction initiated by an incident shock wave 

(7) Reaction in a perfectly stirred reactor 

Any kinetic reaction problem for which temperature is not 
assigned may either be adiabatic or have a prescribed rate of 
heat exchange with its environment. 

In this chapter we describe the computational capabilities 
of LSENS. We also discuss convenience features and the 
calculation procedures used for the thermodynamic and 
transport properties. 


8.1 Types of Chemical Reaction and 
Rate Coefficient 

Many different types of elementary chemical reaction are 
considered. In addition, provision has been made for both 
reversible and irreversible reactions. Each reaction is as- 
sumed to involve up to a maximum of two different reactant 
species and two different product species and thus can be 
written in the general form 

v^+v^ ^v"S 3 + v"S 4 (8.1) 

where v/ is the stoichiometric coefficient (i.e., number of 
moles) of reactant species i in the reaction, v/' is the stoichio- 


metric coefficient of product species i in the reaction, and fi i 
is the chemical symbol for species i. In equation (8.1) spe- 
cies Si and/or S4 may be either absent or the general third- 
body collision partner M. Therefore all collisional processes, 
including isomerization and spontaneous activation and deac- 
tivation of excited species, are considered. In addition, pho- 
tochemical reactions of the following type are allowed: 


hv + v' 2 S 2 V3S3 + v"S 4 (8.2) 

where hv represents a single quantum of radiation absorbed 
by the reactant. This reaction is an irreversible decomposi- 
tion. 

All reactions are assumed to be elementary (i.e., real 
molecular events, e.g., ref. 1), so that the { v/) and { v/'} are 
integers. Also all species are assumed to be ideal gases. For 
each reaction], irrespective of its type, the forward rate coef- 
ficient k } is usually given by the empirical expression (ref. 2) 


kj = AjT J exp 


RT 


(8.3) 


In this equation the preexponential factor Ay, the temperature 
exponent r\j , and the activation energy Ej are constants, R is 
the universal gas constant, and T is the temperature. Provi- 
sion has also been made for the following alternative form of 
the rate coefficient expression (ref. 3): 


kj = AjT n * exp(cjT) (8.4) 

where cj is a constant. 

The backward rate coefficient k-j need not be specified for 
a reversible reaction. For both forward rate coefficient 
expressions k-j is computed within the code by using the 
principle of detailed balancing or microscopic reversibility 
(refs. 1 and 4): 
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(8.5) 


Here *cj is the concentration equilibrium constant for reac- 
tion j and for a given temperature is computed as follows 
(ref. 4): 


Xcj-M'^'exp 


( _ K r o ^ 

^ G T, j 

RT 


( 8 . 6 ) 


In this equation A nj is the change in the total number of 
moles when the reactants are converted into products 


4 2 

An j = 'L^-'L yf ij ( 8 - 7 ) 

1=3 /=! 

where v{j and v(j are, respectively, the stoichiometric coeffi- 
cients of reactant species i and product species i in reaction j. 
The term A Gfj is the standard-state (here 1 atm) Gibbs func- 
tion change for the jth reaction at temperature T 

4 2 

( 8 . 8 ) 

i=3 i=l 

where g?(7) is the standard-state Gibbs function of species i 
at temperature T. The calculation procedure for g? is de- 
scribed in section 8.6. 


able. If we represent the assigned variable by A v and the 
variable it is a function of by ^4, the third-degree polynomial 
representation used in the code is given by 

= ^,0 + ^ A + + G ^ a ,3 ( 8 . 10 ) 

where the {C^j} are constants. The second method requires 
values for ^,i (* = and the corresponding A v j 

(/ = l,...,Ak) at the N \ discrete points. 

For both static and flow problems A v and its first deriva- 
tive dAyfdt, must be evaluated for a given value of ^ (see the 
equations in appendix A). Because the p-t profile for a static 
problem is a particular case of the A v -^4 profile for a flow 
problem, we restrict discussion to the latter case. However, 
there is one fundamental difference between the two cases. 
For static problems ^4 (= t) and £ (= t) are the same, but they 
may be different for a flow problem. We postpone to section 
8.4 a description of how ^4 is calculated and will assume in 
the rest of this section that it is known. 

If the assigned variable profile is specified by a polyno- 
mial, its value is obtained from equation (8.10), its first de- 
rivative with respect to ^ is given by 

^ = (8- 11 ) 

and dAyfd\ is then computed by using the chain rule of 
differentiation as 


8.2 Assigned Variable and Specification 

For a static problem the density p is constant or the pres- 
sure p is specified, either as a constant or as a function of 
time t. The following two methods for specifying the pres- 
sure-time profile are built into the code: (1) as a polynomial 
function of up to third degree 


pit) = C, 0 + C u \ t + C U 2 f 2 + C, 3 f 3 (8.9) 

where the {C t j} are constants, and (2) in tabular form, 
wherein the pressure pi ( i = 1,...^Va) is assumed to be given at 
each of the N a discrete points f, (i = 1,...,^). 

For a flow problem the pressure p or the area A is assigned, 
either as a constant or as a function of time or distance, inde- 
pendently of the choice of the independent variable ^ for the 
governing ordinary differential equations (ODE’s). For clar- 
ity in presentation we will refer to ^ as the “integration vari- 
able.” To specify the assigned variable (pressure or area), 
that is, the variable that can be assigned as nonconstant, the 
two methods given previously for a static problem are avail- 


d\ dA v d^ A 

4 " 4 


( 8 . 12 ) 


When the assigned variable profile is specified in tabular 
form, A v and dA v ld ^ 4 are determined by cubic spline interpo- 
lation with parabolic runout at the end conditions (e.g., 
refs. 5 and 6); dA v ld J; is then given by equation (8.12). 


8.3 Assigned-Temperature Problem 

The temperature of the reacting system may be assigned 
for both static and flow problems, either as a constant or as a 
function of time or distance, independently of both £ and ^4. 
The same two methods described in section 8.2 for the 
assigned variable are built into the code for specifying the 
temperature. 

If we denote by the variable that T is assigned as a 
function of, the polynomial representation used in the code is 
given by 
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T(Z, t ) - c ^ 0 + c % tA % t + c %r 2 + c^ 3 Q 


(8.13) 


8.4 Time and Distance Computations for Flow Problem 


V(t) = qq + flif 4- a 2 ^ + (8.15) 


where the {C^ r ,y} are constants. The tabular form of profile 
specification requires values for £7;/ and 

the corresponding 7} (i = l,...^) at the /^discrete points. In 
either case T and its first derivative dT/dt, must be evaluated 
for a given For a static problem £7 = £, (= r), but for a flow 
problem ^7 may be different from £ and, if so, is evaluated as 
described in section 8.4. 

The procedures for computing T and dTId % are exactly the 
same as those described in section 8.2 for computing the as- 
signed variable and its first derivative. For a polynomial rep- 
resentation T and dTid\j are obtained from equation (8.13). 
If the temperature is specified in tabular form, the same cubic 
spline interpolation routine used to compute the assigned 
variable and its first derivative gives T and dTfd^j. In both 
cases, if the chain rule of differentiation, analogous to 

equation (8.12), is used to calculate dTIct^. 


where the constants [aj] have to be determined. By requir- 
ing that V and dV/dt satisfy the constraints 


V(r„_,) = V„_, 


dV_ 

dt 


dV_ 

dt 


= VVl 


= V„ 


(8.16) 


8.4 Time and Distance Computations 
for Flow Problem 

As discussed in sections 8.2 and 8.3, for a flow problem 
the independent variable ^4 for the assigned variable (pres- 
sure or area) and/or the independent variable ^7 for the tem- 
perature may be different from the integration variable It 
is therefore necessary to compute the distance jc (or time t) 
when time (or distance) is the integration variable. The most 
obvious way of accomplishing this objective is to treat dis- 
tance (or time) as an additional dependent variable when time 
(or distance) is the integration variable and solve its ODE. 
For example, if time is the integration variable, the ODE for 
distance is given by 


dt 

x(t = ? 0 ) = Given 


(8.14) 


where V is the velocity. However, this method introduces 
another ODE and increases the size of the iteration matrix. 
In the present work an alternative, easier calculation proce- 
dure, a cubic spline interpolation that is described here, is 
used to compute x (or t) from t (or x). 

The ODE solver used in LSENS generates numerical solu- 
tions at discrete points ( n - 1,2,...). We assume that time 

is the integration variable and that the solution has been ad- 
vanced over the time step [t n -i,t n ] of size h n (= t n - t n -\). 
We now assume that V varies locally (i.e., in the interval 
[t n - [ y t n ]) as a cubic polynomial 


where V n and V n are the numerical solution values for V and 
dVIdt at t - t n , we can solve for the four unknowns oq to a?>. 
Substituting the solutions for these quantities into equa- 
tion (8.15) and rearranging terms gives 


vw = v„_, +(/-/„_. )vv, 


f-Vi' 

2( 

K J 

V 


3V n -3V n .-h„V n -2hV n -\ 

n n — 1 n n 1 




V n ! 




™ n -W n -X-K V n-h n V n . X 

V J 


(8.17) 


• • 

The derivatives V n -\ and V n are obtained from the Nordsieck 
history arrays z n -\ and z„, respectively. This history array 
contains the solution and its scaled derivatives. Substituting 
equation (8.17) into equation (8.14), integrating over the 
interval [t n ~ \>t n ]> and collecting terms give the following 
expression for x n \ 


( \ 


Vn-l-Vn 

2 ) 

12 


l J 


(8.18) 


If distance is the integration variable, we replace h n in 
equation (8.18) by the difference t n - t n -\ t where t n -\ is 
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known and t n has to be computed. Also, we replace the dif- 
ference x n - x n -i by h n> the step size used on the step 
[xn-irX „]. Finally, because x is the integration variable, we 
use the chain rule of differentiation to replace dVfdt by 
V dV/dx (= W). The resulting equation can then be regarded 
as a quadratic equation in the quantity t n - t n - Its solution 
is given by 



3 


(8.19) 

where we have used the positive root to ensure that t increases 
as the integration proceeds. (Because the overall reaction prob- 
lem is irreversible, we can solve the governing ODE’s only 
for increasing t.) The difficulty ^with equation (8.19) is the 
possibility of overflows if V n -\V n -\ = V n V n . For example, 
for constant-velocity flow V n -\ = V n and V n - \ = V n (= 0), 
and this condition is obtained. We avoid this difficulty 
by multiplying both the numerator and denominator of equa- 
tion (8.19) by the quantity 



Performing this operation and then simplifying the resulting 
expression give the following equation for t n : 



( 8 . 20 ) 


is most likely that exact heat transfer rates will not be known 
when modeling an experimental reacting system. Therefore 
the main usefulness of the code will be in determining the 
effects of various assumed heat transfer rates. It was previ- 
ously assumed (ref. 7) that the simplest expression for the 
heat loss rate is a polynomial function of the reacting mixture 
temperature. Therefore the standard option for specifying the 
heat transfer rate Q for a static problem or the heat transfer 
rate per unit length in the flow direction Q ' for a flow prob- 
lem is given by the polynomial expression 

Q (or G') = H r o + H t j T + Hj 2 T 2 + Hj 3 T 3 + H T 4 T A 

( 8 . 21 ) 

• # 

where the [Hjj] are constants. Note that (2 (or Q) can be 
made negative to simulate a heat source for an ignition prob- 
lem. This heat transfer model is also used to compute the 
heat transfer rate for a perfectly stirred reactor problem. 

For one-dimensional flow problems another calculation 
procedure for Q is included in LSENS. In this model Q is 
given by the following empirical expression (e.g., ref. 8): 

Q'= $HL W (T- T w ) (8.22) 

where SW is the heat transfer coefficient (heat transfer rate per 
unit surface area per unit temperature difference), L w is the 
perimeter of the flow cross section, and 7^ is the wall tem- 
perature. For a cylindrical tube of diameter D the cross- 
sectional area A = 7tD 2 /4, so that 

L w = kD = 2Vtl4 (8.23) 

Substituting this equation into equation (8.22) gives 

Q^lJnA'&iT-Tn) (8.24) 

Many correlations can be used to estimate 34 (e.g., ref. 8 ). 
For turbulent flow we use the following empirical correla- 
tion: 

^^ = 0.023Re° 8 Pr° 3 (8.25) 

K 


which avoids the problem of overflow errors. 

8.5 Heat Transfer Models 

The heat transfer rate between a reacting system and its 
surroundings is in general a function of the reacting gas and 
ambient temperatures, as well as flow rate and geometry. It 


In this equation Re and Pr are, respectively, the Reynolds and 
Prandtl numbers: 


and 



(8.26) 



(8.27) 
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where 1 1, c p> and K are, respectively, the mixture dynamic vis- 
cosity, mass-specific heat at constant pressure, and thermal 
conductivity. These properties are evaluated at the fluid bulk 
temperature, which is equal to the reacting fluid temperature 
for one-dimensional flow (ref. 8). The thermodynamic prop- 
erty c p and the transport properties (i and k for the mixture 
are computed by using the empirical equations given in 
sections 8.6 and 8.7, respectively. The correlation given by 
equation (8.25) is used for flows with Re > 2300. For 
laminar flow (Re < 2300) the following correlation is used 
(ref. 8): 


Cli r\ 

— — = 4.364 (8.28) 

K 

This model is used to compute the heat transfer rate per 
unit mass of reacting mixture Qlm for one special static 
reaction application — the assigned-pressure, variable-volume 
reaction in the cylinder of an internal combustion, or Otto- 
cycle, engine. We assume that the cylinder has diameter B 
(bore) and length L s (stroke) and that heat transfer occurs 
only through the curved cylindrical surface. The heat trans- 
fer rate per unit mass of mixture is then given by 


q _ ^A S (T-TJ _ 4^(T-T W ) 
m p°l/ Bp 


(8.29) 


where A s is the instantaneous area of the curved surface, QJ is 
the instantaneous chamber volume, and we have used the fact 
that = BI4 for a cylinder. To compute we use the 
correlation of equation (8.25) or (8.28) with D replaced by B 
and the Reynolds number computed by (ref. 9) 


Re = 


p L S £IB 
Tip 


(8.30) 


where Q is the cranking angular velocity in radians per sec- 
ond and is calculated from the engine speed RPM in revolu- 
tions per minute by 


8.6 Thermodynamic Properties 

McBride (refs. 10 and 1 1 ). For each species i the non- 
dimensional properties molar-specific heat at constant pres- 
sure C pjfR, molar-specific enthalpy and the 1-atm 

molar-specific entropy 8°//? are specified as functions of 
temperature 


= «,i+ a a T+ a 0 T 2 +a iA T 3 + a l5 T 4 (8.32) 

J^ = a.. + — 7+ — 7" 2 + — r 3 + — r 4 +— (8.33) 

RT ,A 2 3 4 5 T 

I. T j. /i . a i,3 -J-2 ^i. 4 ... 3 . 5 - r 4 

R ,l l ' 2 2 3 4 ° 


(8.34) 


In these equations R is the universal gas constant and the de- 
gree sign indicates standard conditions (here pressure of 
1 atm). This superscript is not attached to the specific heat 
and enthalpy because the two properties are independent of 
pressure for ideal gases. 

For each species i the seven coefficients a/j to a x j are 
computed with the Properties and Coefficients (PAC) code of 
McBride and Gordon (ref. 12). For ideal gases this program 
first calculates thermodynamic properties from molecular 
constant data given in the JANAF thermochemical tables 
(e.g., ref. 13) and then reduces them to coefficient form. For 
each species two sets of coefficients for use on two adjacent 
temperature intervals, 300 to 1000 K and 1000 to 5000 K, are 
included. The data are constrained to give the same results at 
1000 K. 

Another thermodynamic property that is required for 
chemical kinetics computations is the standard-state, molar- 
specific Gibbs function g°. The normalized Gibbs function 
g °IRT is given by 


9° _ h ; -Kg 

RT RT 


(8.35) 


7i RPM 

30 


(8.31) 


8.6 Thermodynamic Properties 

The thermodynamic properties of the species are computed 
by using the empirical equations given by Gordon and 


The thermodynamic properties { dt pi ldT\ may also be 
required and are obtained by differentiating equation (8.32) 
with respect to T. 

The thermodynamic properties of the reacting gas mixture 
are evaluated by applying Gibbs theorem (e.g., ref. 14), that 
is, by simply summing the contributions made by each spe- 
cies: for example, the mixture mass-specific enthalpy h is 
given by 
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NS 

h = ^li, a, (8.36) 

i=l 

where a, is the number of moles of species i in unit mass of 
mixture and NS is the total number of (reacting and inert) 
species. 


8.7 Transport Properties 


NS I 

f 

/ns ^ 

II 

M 

j* 

°'/ 

'Xv, 

i=l 1 

/ 

/ = » J 


where 


(8.41) 




4' 


1 + 


'V 


J 


M, 




\ 3 / 4 / ^ 

' ' 1 + 577 


il/2 


AT 


1 + SjIT 


'l + Sy/T ^ 

1 Tslf 

\ 1 / 


The transport properties of the species are computed by 
using the empirical equations given by Zeleznik and McBride 
(ref. 9); see also Gordon et al. (refs. 11 and 15). For each 
species i the dynamic viscosity p, and the thermal conductiv- 
ity K( are specified as functions of temperature in the form 
used by Maitland and Smith (ref. 16): 


In p - =a i ^ In T + ■ 


b : 




H + J 

rrl W 


(8.37) 


b; „ C- 

In K f = a- In T + — 1 — + — — + d- 
I J 2 *’ K 


(8.38) 


The coefficients in these equations are obtained by least- 
squares fitting and give viscosity in units of micrograms per 
centimeter-second and thermal conductivity in units of 
microcalories per second-centimeter-Kelvin. 

The transport properties p and k for the gas mixture are 
also computed by using the procedures given by Zeleznik 
and McBride (ref. 9). The mixture viscosity is calculated 
with the formula suggested by Wilke (refs. 17 and 18): 


NS 


1=1 


f /NS 
/ ;=| 


(8.39) 


where 


f2 


1 + 


v“ 


M 


v 1/4 




*¥- 




vl/2 


(8.40) 


Af 


W,J J 


where M w j is the molar mass of species i. 

For the mixture thermal conductivity the formula proposed 
by Lindsay and Bromley (ref. 19) is used: 


(8.42) 


In this equation S, is the Sutherland constant for the z‘th spe- 
cies and Sy is the Sutherland interaction constant for species 
i and j (refs. 9 and 15). The constant S/ is obtained from the 
viscosity as follows (ref. 9): 



din p. ^ 
din T j 


(8.43) 


The constant Sy is generally assumed to be of the form 
(refs. 9 and 15) 


Sq^Cij^S] (8.44) 

where Cy is a constant. Lindsay and Bromley (ref. 19) 
recommend the value Cy - 1 , except when one of the species 
i and j is highly polar. For this case the value Cy = 0.733 is 
suggested (ref. 9). We use Cy = 1 for all pairs of species ex- 
cept those involving water, for which Cy is set equal to 0.733. 


8.8 Simplified Composition Input 

The initial mixture composition may be specified by 
means of the species mole fractions x / (1 = 1,...,NS) or mass 
fractions y t ( i = 1,...,NS). The internal composition variables 
{a,} are then computed by 


JC; 


NS 


/ = ! NS (8.45) 




or 
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i = NS 


(8.46) 


CT i = 




M, 


W,t 


The code also includes the option of specifying the initial 
composition for any reaction involving the general hydrocar- 
bon fuel C„ H„ O n by the simple means of either the fuel- 
oxidant equivalence ratio (p or the fuel-oxidant mass ratio fla . 
The oxidant may contain oxygen, nitrogen, argon, and carbon 
dioxide in any proportion. A “standard air’ 1 oxidant has been 
built into the code, but the user has the option of changing it. 
The composition of this oxidant is given in table 8. 1 . Its 
molar mass is 28.9644. The quantities X\ and y, in table 8.1 
are the mole and mass fractions, respectively, of species i in 
the oxidant, and ft/ is the ratio of the mole fraction of oxidant 
species i to that of oxygen 


8.9 Net Reaction and Species Formation Rates 
the definition of (p that 


X f _ 4<p 

X 0 , 4n C + n H “ 2n O 


(8.50) 


where the subscript/ denotes fuel. 

Now the mole fraction of each oxidant species i in the fuel- 
oxidant mixture is related to xq 2 via 

x i=\ x o 2 (8.51) 

which together with equation (8.50) and the identity 


x f + x o 2 + * n 2 + x at + x co 2 1 (8.52) 


V 



(8.47) gives the following expression for xq : 


For the standard air given in table 8.1 it is the {ft/} values that 
are built into the code. 

To obtain the relations between species mole fractions and 
(p or f/a, we use the stoichiometric fuel-oxygen reaction 


C« H„ CL ■+■ 

n C n H n O 


4« c+ »H-2 / i o q 2 ^ ncCC>2 + M h 2 0 


(8.48) 


x = 4 «c+«h- 2w o 

° 2 4(p + (4n c +n H -2« 0 )(l + /t N2 + /i Ar + \ :02 ) 


(8.53) 


The fuel and oxidant species mole fractions can then be com- 
puted by using equations (8.50) and (8.51). Finally equation 
(8.45) gives the {a/}. 

If the fuel-oxidant mass ratio is specified, we first compute 
x f/xo 2 by using the relation 


which is valid for any fuel with (4 riQ + «h) > 2n<> The fuel- 
oxidant equivalence ratio is defined as 


x f _ 

x 0 2 M w.fX 0 2 


F/O 

( F/0) s 


(8.49) 


where FIO is the actual fuel-oxygen molar ratio and ( FIO) s is 
its stoichiometric value. It is clear from reaction (8.48) and 


TABLE 8.1.— STANDARD OXIDANT 
COMPOSITION BUILT INTO LSENS 
[Molar mass, 28.9644.] 


Species, 

Si 

Mole 

fraction. 

Mass 

fraction, 

y ( 

Mole 

fraction ratio, 
A / ( = x,/ x o 2 ) 

n 2 

0.78088 

0.75524 

3.727350 

o 2 

0.20950 

0.23145 


Ar 

0.00932 

0.01285 

0.044487 

co 2 

0.00030 

0.00046 

0.001432 


where the subscript “air” denotes oxidant and 

=- 5 (8.55) 

2 1 + ,I N 2 + /, Ar + , t0 2 

Equation (8.50) then gives (p, from which the initial mixture 
composition can be computed by using the procedure 
described above. 


8.9 Net Reaction and Species 
Formation Rates 

The relative importance of the j'th reaction to the formation 
or destruction rate of the ith species can be gauged by exam- 
ining its net reaction rate per unit volume rj and the time rate 
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8. Capabilities of Code 

of change of a, due to the j th reaction, ( dOi/dt)j . However, 
these rates are converted to more useful quantities as follows: 
For each reaction j the code computes the net reaction con- 
version rate Xj t which is defined as 



(8.56) 


rj y equation (8.57). Now rj will be positive or negative de- 
pending on the magnitudes of Rj and R-j. If Rj is greater 
than R-j, we divide equation (8.57) by Rj to get 



(8.59) 


where rj is given by 


r j = Rj - R_j (8.57) 

Here Rj and R-j are, respectively, the molar forward and 
reverse rates per unit volume of reaction j. The larger magni- 
tudes of the {Xj} make it easier to use them than the {rj} to 
compare net reaction rates. The net molar rate of formation 
of species i per unit volume by reaction j, co^, which is 
defined by 


If the reaction is far from equilibrium, Rj will be significantly 
larger than R-j and the ratio rj/Rj will be a positive number 
very close to unity. If the reaction is near equilibrium, 
Rj — R-j and rj/Rj will be a positive number close to zero. 
Therefore rj/Rj varies between 0 and 1 for the extreme situa- 
tions of equilibrium (Rj = R-j) and irreversibility ( R-j = 0). 

If, however, R-j is greater than Rj> we divide equation 
(8.57) by R-j to get 



(8.60) 


co 


U 




(8.58) 


is also generated. The {to^} are useful in developing a 
chemical kinetic mechanism because they show which reac- 
tions are important in forming or destroying a species. 


8.10 Equilibration Factor 

It is often important to know how far a chemical reaction 
is from its equilibrium condition. To determine the state of 
the yth reaction, we derive a simple equilibration factor from 


and the ratio rj/R-j varies between 0 and -1 for the extreme 
conditions of equilibrium (Rj = R-j) and irreversibility 
(Rj = 0 ). 

The two ratios, equations (8.59) and (8.60), can be com- 
bined into a single equilibration factor E q j 


hr 


max 



(8.61) 


where the vertical bars denote absolute value and 0 < E q>J < 1. 
The equilibration factor is useful in determining the effect of 
a single reaction on the entire complex process and is com- 
puted for each reaction. 
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Chapter 9 

Code Organization and Description 


9.1 Introduction 

The present version of the LSENS code, dated July 22, 
1992, is in double precision. It is compatible with most 
FORTRAN 77 compilers. However, it contains detailed 
instructions on how to convert it to FORTRAN 66. The 
MAIN program lists all routines requiring modifications. 
Also, in each such routine both the changes and the lines 
where they must be made are given. 

The code was developed on the NASA Lewis Research 
Center’s IBM 370/3033 computer using the TSS operating 
system (OS) and the Amdahl 5870 computer using the UTS 
OS. It has also been successfully executed on the following 
computer systems: NASA Lewis Research Center’s Amdahl 
5870 using the VM/CMS OS, Cray-X/MP/2/4 using the COS 
and UNICOS operating systems and the CFT and CFT77 
compilers, Cray- Y/MP/8/6 128 using UNICOS 6.0 and 
CFT77, Alliant FX/S, Convex C220 minicomputer using the 
Convex 8.0 OS, and VAX 11/750, 1 1/780, 1 1/785, 6320, 
6520, 8650, 8800, and 9410 using the VAX/VMS OS and 
VAX FORTRAN compiler; NASA Ames Research Center’s 
Cray-2 and Cray-Y/MP using UNICOS and CFT77; the Sun 
SPARCstation 1 using the Sun 4.1 OS; several IRIS worksta- 
tions using the IRIX 4.0.1 OS and F77 compiler; and the 
IBM RISC System/6000 using the AIX 3.1 OS and the XLF 
and F77 compilers. 

The code consists of a MAIN program, 59 subprograms, 
and a BLOCK DATA module. Table 9. 1 lists these subpro- 
grams in the order that they appear in the code and briefly 
describes them. The subprograms SECCPU, DDOT, 
D1MACH, IDAMAX, and VNORM are function routines; 
all others are subroutines. Also the routine CUBS contains 
statement functions. The function SECCPU, which computes 
the incremental central processing unit (CPU) time in sec- 
onds, calls the system clock to obtain the total CPU time used 
since initiation of the job. The code uses the following intrin- 
sic and external routines: ALOG, DABS, DBLE, DEXP, 
DFLOAT, DLOG, DMAX1, DMIN1, DSIGN, DSQRT, EXP, 
FLOAT, IABS, IFIX, MAX0, MIN0, MOD, READ, SNGL, 


and WRITE. Finally, subroutines INIT, KINP, TINP, and 
SENSIN use namelists. 

The different subprograms that make up the LSENS pack- 
age are arranged in three blocks or groups as follows: The 
first group contains the MAIN program and those (CIMAGE 
to WSR) related to thermodynamic, transport, and kinetics 
computations. The second group includes the subroutines 
(SENDDM to SNSTAB) required for sensitivity analysis. 
The last group contains the subprograms (LSODE to 
XSETUN) included in the code LSODE (refs. 20 to 22), 
which is used to solve the governing ordinary differential 
equations (ODE’s). Within each group the subprograms are 
arranged alphabetically. The BLOCK DATA module is lo- 
cated at the end of the code. 

LSENS has been arranged as much as possible in a “modu- 
lar” fashion, with different subprograms performing different 
tasks. However, to avoid unnecessary work, some computa- 
tions are performed in subprograms other than where they 
naturally belong. An example is the calculation of the ther- 
modynamic properties dtp JdT (i = 1,...,NS), where is the 
constant-pressure, molar-specific heat of species i, T is the 
temperature, and NS is the total number of (reacting and in- 
ert) species. These derivatives are needed only for the com- 
putation of certain elements of the Jacobian matrix (see eq. 
(9.2)), which is required for the numerical integration of the 
ODE’s and for sensitivity analysis. Hence they are com- 
puted in subroutine PEDERV, which computes the Jacobian 
matrix, and not in subroutine THRM, which computes all 
other thermodynamic properties of the species (table 9.1). 

Because the code is designed to be modular, the number of 
subprograms is fairly large. However, this feature aids in 
both understanding and, if necessary, modifying the code. In 
addition, as improvements are made in any calculation proce- 
dures or methods built into the code, only the subprograms 
using these procedures need to be replaced. An example is 
the computation of thermodynamic data. The relations built 
into the code are based on fitting data over two temperature 
ranges. Work is now under way to extend the temperature 
range over which the calculations are valid; it requires the 
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TABLE 9.1— DESCRIPTION OF SUBPROGRAMS USED IN LSENS 


Subprogram 

Description 

MAIN 

Manages solution of problem by calling chemical kinetics preprocessor, integrator or perfectly stirred reactor 
solver, and output subprograms. Also computes CPU times and prints them. 

CIMAGE 

Reads in and prints image of input data for each case. 

COMB 

Manages calls for equilibrium calculations. Also computes CPU time for this calculation and prints it. 

CUBS 

Computes assigned variable or temperature and its first derivative by using either user-supplied polynomial equation or 
cubic spline fit of user-provided table of values. 

DIFFUN 

Computes derivatives of dependent variables with respect to independent variable. 

ELEMNT 

Computes element composition in atoms per gram of mixture. 

EQLBRM 

Performs equilibrium computations for assigned pressure and enthalpy, assigned pressure and temperature, assigned density 
and internal energy, and assigned density and temperature. 

GAUSS 

Solves a set of linear equations by using Gaussian elimination. 

HETRAN 

Computes heat loss terms and, if necessary, reads in viscosity and thermal conductivity data. 

INIT 

Reads in initial (or reactor inlet) mixture composition and values of thermodynamic and flow variables. 

KINP 

Processes and checks legality of all input data including reaction mechanism but not temperature profile for assigned- 
temperature problem or sensitivity analysis data. At user’s option, tests reaction mechanism uniqueness and atom/charge 
balance of each reaction. 

MATRIX 

Sets up matrices used in equilibrium computations. 

OUT1 

Prints all input information including reactions and rate coefficient parameters. 

OUT2 

Prints general output for kinetics and sensitivity problems and equilibrium solution for perfectly stirred reactor problem. 

PEDERV 

Computes elements of Jacobian matrix. 

RKTOUT 

Computes and prints rocket performance parameters. 

RXNTAB 

Tabulates and prints reaction numbers in order of decreasing importance for each species (i.e., decreasing rates of production 
of each species by reactions) and prints all nonzero rates of production by each reaction for every species. 

SECCPU 

Computes CPU time increment in seconds. 

SHOCKS 

Solves incident shock equations for equilibrium and frozen cases. 

SHOK 

Manages setup and subprogram calls for incident shock calculations. Also, computes and prints CPU times for equilibrium and 
frozen shock calculations. 

SPLINE 

Performs cubic spline fit by using first-derivative method with parabolic runout for end conditions. 

SPOUT 

Prints results of shock and equilibrium problems. Also transfers frozen shock results to input of shock-kinetics problem and, 
if necessary, computes characteristic shock tube reaction length. 

THRM 

Computes nondimensional thermodynamic properties of species. 

TINP 

Processes and checks legality of temperature-related data for assigned-temperature problem. 

WSOUT 

Prints perfectly stirred reactor solution. 

WSR 

Performs perfectly stirred reactor computation. 

SENDDM 

Main integration and sensitivity solution driver. Manages call to core integrator and sensitivity subprograms that set up work 
array pointers and initialize sensitivity arrays. 

DFDP 

Computes partial derivatives of temporal derivatives of dependent variables with respect to sensitivity parameters. 

DMACHK 

Sets up real and integer work array pointers for core integrator and sensitivities, and checks that storage requirements are met. 

DMINIT 

Initializes sensitivity arrays. 

DMINTR 

Interpolates for sensitivity coefficients and their derivatives at output times. 

DMPJAC 

Computes iteration matrix and manages subprogram call for its LU-decomposition. 

DMPRNT 

Prints storage and computational work requirements for sensitivity analysis. 

DMSTOD 

Advances sensitivity solution by one time step. 

SENSIN 

Processes and checks legality of input data for sensitivity computations. 

SNSOUT 

Computes and normalizes sensitivity coefficients when pressure sensitivities are not required. Prints normalized sensitivity 
coefficients. 

SNSPSC 

Computes and normalizes sensitivity coefficients when pressure sensitivities are required. 

SNSTAB 

Tabulates and prints reaction numbers in order of decreasing importance (i.e., normalized sensitivity) and nonzero normalized 
sensitivity coefficients for each dependent variable. 

LSODE 

Main core integration routine. Checks legality of input, sets work array pointers, initializes work arrays, computes initial 
integration step size, manages solutions of ODE’s for both kinetics problems and sensitivity coefficients, and returns to calling 
routine with solutions and errors. 

CFODE 

Sets method coefficients for solution and test constants for local error test and step size and method order selection. 

DAXPY 

Forms the sum of one vector and another times a constant. 

DDOT 

Computes dot product of two vectors. 

DGBFA 

Performs LU-decomposition of a banded matrix by Gaussian elimination. 

DGBSL 

Solves a linear system of equations using a previously LU-decomposed banded matrix. 
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9.1 Introduction 


TABLE 9.1— Concluded. 


Subprogram 

Description 

DGEFA 

Performs LU-decomposition of a full matrix by Gaussian elimination. 

DGESL 

Solves a linear system of equations using a previously LU -decomposed full matrix. 

DSCAL 

Scales a vector by a constant. 

D1MACH 

Computes unit roundoff of computer. 

EWSET 

Sets error weight vector. 

IDAMAX 

Identifies vector component of maximum absolute value. 

INTDY 

Computes interpolated values of specified derivative of dependent variables. 

PREPJ 

Computes iteration matrix and either manages subprogram call for its LU-decomposition or computes its inverse. 

RSCOM 

Restores contents of common blocks LS0001 and EH0001. 

SOLSY 

Manages solution of linear system arising from chord iteration. 

STODE 

Advances solution of ODE’s for model problem by one integration step. Also, computes step size and method older to be 
attempted on next step. 

SVCOM 

Stores contents of common blocks LS0001 and EH0001. 

VNORM 

Computes weighted root-mean- square norm of a vector. 

XERRWV 

Handles error messages from LSODE package and sensitivity routines DMACHK, DMINTR, and DMSTOD. 

XSETF 

Resets print control flag for error messages from XERRWV. 

XSETUN 

Resets logical unit number for error messages from XERRWV. 


use of several temperature ranges (ref. 12). In order to incor- 
porate the new calculation procedure into LSENS, only 
THRM has to be replaced and suitable modifications made to 
PEDERV and appropriate common blocks. 

Communication between different subprograms is accom- 
plished by means of both call sequences and common blocks, 
which are used extensively in LSENS. The reason for using 
common blocks is to avoid lengthy call sequences, which can 
significantly deteriorate the efficiency of the program. The 
common blocks, if any, used by each subprogram are given 
in table 9.2. This table also lists all subprograms called and 
referenced (e.g., an external function) by each subprogram. 
Also, in order to facilitate the use of LSENS in overlay situ- 
ations, all subprograms that call and reference each subpro- 
gram are listed. Finally for each subprogram the table gives 
entry names in parentheses and dummy procedure names 
(which are passed in call sequences and have to be declared 
external in each calling and called subprogram) in brackets. 
Although we have listed only those common blocks that are 
actually used by the MAIN program, it contains every com- 
mon block used in the code so that it can be used in overlay 
situations. 

All the common blocks used in the code are listed in 
alphabetical order in table 9.3. Also given in this table are 
the variables contained in each common block and their di- 
mensions, if different from unity. To further assist in user un- 
derstanding and modification of the code, we have included 
in table 9.3 the names of all subprograms that use each com- 
mon block. It must be pointed out that not all variables listed 
for a given common block are needed by each routine that 
contains it. For this reason some subprograms may use 
dummy names, which are not listed in table 9.3, and vari- 


ables with the same names may be declared to be of different 
lengths in different routines. 

Each subprogram contains type declarations for all vari- 
ables used in it. Such declarations are useful for debugging 
and provide a list of all variables that occur in a routine. This 
list is useful in overlay situations (ref. 23). The type declara- 
tions are arranged in a specific order to enhance their utility. 
At the beginning of each routine the variables are listed in 
blocks of statements, with each block corresponding to a par- 
ticular data type. The variable types are listed in the follow- 
ing order: character, logical, integer, real, and double preci- 
sion. Within each block of data type the variables are usually 
listed in the following order: variables passed in the call se- 
quence, local array variables, variables appearing in common 
blocks, and finally local scalar variables. In some of the sen- 
sitivity and integration subprograms and in the BLOCK 
DATA module this order is not followed strictly. Instead, we 
have placed together blocks that belong to the same program 
group; however, character variables, if any, are always listed 
first. For variables that appear in each common block we 
have, in general, used a separate data-type statement. For a 
given data type these declarations are listed in the same order 
as the common blocks. Also, in virtually all data-type decla- 
ration statements the variables are listed in alphabetical order. 

The variable-type declaration statements are followed by 
DIMENSION statements. We first list variables included in 
the call sequence, then variables that appear in namelists, and 
finally local array variables. Following the DIMENSION 
statements, if any, all common blocks are listed in alphabeti- 
cal order. Again in some subroutines this order is not strictly 
followed, and common blocks that belong to the same pro- 
gram group are placed together. However, within each such 
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TABLE 9.2 — ROUTINES WITH COMMON BLOCKS, SUBPROGRAMS, AND CALLING SUBPROGRAMS 


Subprogram 
[Dummy proce- 
dure name] 
(Entry names) 

Common blocks used 

Subprograms called and referenced 

Calling subprograms 

MAIN 

COND 

DIRECT 

GEAR9 

DIFFUN 

KINP 

OUT1 




LS0001 

LS0002 

LTUS 

OUT2 

PEDERV 

RXNTAB 




MISC 

NECC 

ODECON 

SECCPU 

WSR 

SENDDM 




OPTS2 

PRIN 

PROP 

DFDP 

DMPRNT 

SNSOUT 




SAVRAT 

SENNOR 

SENPAR 

INTDY 






SENVAR 

SINT 







CIMAGE 

LTUS 






KINP 


COMB 

COND 

INDX 

LTUS 

ELEMNT 

EQLBRM 

SECCPU 

KINP 



MISC 

NECC 

OPTS2 

SPOUT 






POINTS 

SPECES 







CUBS 

AFUN 

COND 

LTUS 

SPLINE 



DIFFUN 

KINP 

(CINP) 







TINP 


DIFFUN [F] 

COND 

CUBASV 

CUBTMP 

CUBS 

HETRAN 

THRM 

MAIN 

WSR 

(DIFFW, DIFF1) 

GHSC 

LTUS 

NECC 




DMSTOD 

LSODE 


ODECON 

OPTS1 

OPTS2 




PREPJ 

STODE 


PROP 

RATLOG 

REAC2 







RRAT 

SABS 

SINT 







SPCONC 

SPEC 2 

STCS 







TRAN 

TRAN2 

ZERCON 






ELEMNT 

COND 

INDX 

MISC 




COMB 

SHOK 


SPECES 






WSR 


EQLBRM 

COND 

GHSC 

INDX 

GAUS 

MATRIX 

THRM 

COMB 

SHOCKS 


LTUS 

MATX 

MISC 




WSR 



NECC 

OPTS2 

POINTS 







SPECES 








GAUSS 

COND 

INDX 

MATX 




EQLBRM 

WSR 

HETRAN 

COND 

GHSC 

LTUS 




DIFFUN 

KINP 

(HTWSR, 

NECC 

OPTS1 

PDDTRM 






VISCON) 

SPEC1 

SPEC2 

TRAN 







TRAN2 








INIT 

COND 

FAIR1 

FAIR2 




KINP 



LTUS 

NECC 

ODECON 







OPTS I 

OPTS2 

SAVRAT 







SINT 

SPEC1 

SPEC 2 






KINP 

AFUN 

COND 

CUBASV 

CIMAGE 

COMB 

CUBS 

MAIN 


(WSFLIP, RINP) 

CUBTMP 

ELMNTS 

FAIR1 

HETRAN 

INIT 

SHOK 




GHSC 

INDX 

INERT 1 

THRM 

TINP 

SENSIN 




INERT2 

KOUT1 

KOUT2 







LS0002 

LTUS 

MISC 







NECC 

ODECON 

OPTS1 







OPTS2 

PDDTRM 

PRIN 







PRIN2 

PROP 

RATLOG 







REAC1 

REAC2 

RMTHOK 







ROKET 

RRAT 

SABS 







SAVVAR 

SENVAR 

SINT 







SPECES 

SPEC1 

SPEC2 







STCS 

TCOF 

TRAN 







TSTNOS 

XVSA1 

XVSA2 







XVST2 











TABLE 9.2. — Continued. 


Subprogram 
[Dummy proce- 
dure name] 
(Entry names) 

Common blocks used 

Subprograms called and referenced 

Calling subprograms 

MATRIX 

COND 

GHSC 

INDX 



EQLBRM 



MATX 

MISC 

NECC 






OPTS2 

POINTS 

SPECES 





0UT1 

AFUN 

COND 

CUBASV 



MAIN 



CUBTMP 

FAER2 

GHSC 






INERT2 

KOUTf 

KOUT2 






LS0002 

LTUS 

NECC 






ODECON 

OPTS1 

OPTS2 






PRIN 

PROP 

REAC1 






REAC2 

ROKET 

RRAT 






SAVVAR 

SENNAM 

SENNOR 






SENPAR 

SENVAR 

SINT 






SPEC1 

STCS 

TRAN 






XVSA1 

XVSA2 

XVST1 






XVST2 







OUT2 

AFUN 

COND 

GEAR9 

RKTOUT 


MAIN 

WSR 

(OUTSTR, 

GHSC 

INERT2 

KOUT1 





OUT3) 

KOUT2 

LTUS 

NECC 






ODECON 

OPTS1 

OPTS2 






PROP 

REAC2 

ROKET 






SABS 

SAVRAT 

SINT 






SPCONC 

SPEC1 

SPEC 2 






TRAN 







PEDERV 

COND 

GHSC 

LTUS 



WSR 

DMPJAC 

[JAC] 

MATX 

NECC 

ODECON 



PREPJ 


(PDWSR) 

OPTS1 

OPTS2 

PDDTRM 






PROP 

REAC2 

RRAT 






SABS 

SPCONC 

STCS 






TCOF 

TCOF2 

TRAN 






TRAN 2 

ZERCON 






RKTOUT 

COND 

LTUS 

ROKET 



OUT2 


RXNTAB 

COND 

LTUS 

ODECON 



MAIN 



OPTS1 

REAC2 

SENPAR 






SPEC1 

SPEC2 






SECCPU 




System CPU 


MAIN 

COMB 





clock 


SHOK 

WSR 

SHOCKS 

COND 

GHSC 

INDX 

EQLBRM 

THRM 

SHOK 



LTUS 

MISC 

NECC 






POINTS 

SPECES 






SHOK 

COND 

LTUS 

MISC 

ELEMNT 

SECCPU SHOCKS 

KINP 



NECC 

POINTS 

SPECES 

SPOUT 




SPLINE 






CUBS 


SPOUT 

AFUN 

COND 

CUBASV 

THRM 


COMB 

SHOK 

(ECOUT, 

GHSC 

INDX 

KOUT1 





ESOUT, 

LTUS 

MISC 

NECC 





FSOUT) 

OPTS2 

POINTS 

SPECES 






SPEC1 
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TABLE 9.2. — Continued. 


Subprogram 
[Dummy proce- 
dure name] 
(Entry names) 

Common blocks used 

Subprograms called and referenced 

Calling subprograms 

THRM 

COND 

GHSC 

LTUS 




DIFFUN 

EQLBRM 


TCOF 

TCOF2 





KINP 

SHOCKS 








SPOUT 

WSR 

TINP 

COND 

CUBTMP 

KOUT1 

CUBS 



KINP 


(TMPPAR) 

LTUS 

OPTS1 

OPTS2 







PRIN 

PRIN 2 

SABS 







SAVTMP 

SAVVAR 

TSTNOS 







XVST1 

XVST2 







WSOUT 

COND 

KOUT1 

LTUS 




WSR 



MISC 

NECC 

PROP 







SPEC1 

SPEC2 

TRAN 






WSR 

COND 

GHSC 

INDX 

DIFFUN 

ELEMNT 

EQLBRM 

MAIN 



KOUT2 

LTUS 

MATX 

GAUSS 

OUT2 

PEDERV 




MISC 

NECC 

ODECON 

SECCPU 

THRM 

WSOUT 




PROP 

REAC2 

SPECES 







SPEC1 

SPEC 2 

TRAN 






SENDDM 

COND 

DFDPA 

DIRCT2 

DIFFUN 

PEDERV 

DFDP 

MAIN 



DIRECT 

PRIN 

SENPAR 

DMACHK 

DMINIT 

LSODE 




SENSOL 








DFDP 

COND 

DFDPA 

GHSC 




DMSTOD 



NECC 

ODECON 

OPTS2 







RRAT 

SABS 

SENPAR 







SENVAR 

SPEC 2 







DMACHK 

DIRECT 

SENPAR 


XERRWV 



SENDDM 


DMINIT 

DIRECT 

LS0001 

PRIN 




SENDDM 



SENPAR 








DMINTR 

DIRECT 

LS0001 

SENPAR 

XERRWV 



SNSOUT 

SNSPSC 


SENSOL 

SENVAR 





LSODE 


DMPJAC 




DGEFA 

PEDERV 


DMSTOD 


DMPRNT 

DIRECT 

EH0001 





MAIN 


DMSTOD 

DFDPA 

DIRCT2 

DIRECT 

DIFFUN 

PEDERV 

DFDP 

LSODE 



LS0001 

PRIN 

SAVRAT 

DMPJAC 

SOLSY 

XERRWV 




SENPAR 








SENSIN 

COND 

LTUS 

ODECON 




KINP 



OPTS2 

REAC2 

SENNAM 







SENPAR 

SENVAR 

SPEC1 






SNSOUT 

DIRECT 

GHSC 

LS0001 

DMINTR 

SNSPSC 

SNSTAB 

MAIN 


(SNSOT2) 

LTUS 

NECC 

OPTS 2 







PRIN 

RRAT 

SENNAM 







SENNOR 

SENPAR 

SENSOL 







SENVAR 

SINT 

TSTNOS 
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TABLE 9.2. — Continued. 


Subprogram 


Common blocks used 

Subprograms called and referenced 

I Calling subprograms 

[Dummy proce- 
dure name] 
(Entry names) 









SNSPSC 

DIRECT 

GHSC 

LS0001 

DMINTR 



SNSOUT 



NECC 

ODECON 

PRIN 







RRAT 

SAVRAT 

SENNOR 







SENPAR 

SENSOL 

SENVAR 







SINT 

TSTNOS 







SNSTAB 

LTUS 

SENNAM 

SENPAR 




SNSOUT 



SENSOL 

SENVAR 







LSODE 

COND 

DIRECT 

LS0001 

DIFFUN 

PEDERV 

DFDP 

SENDDM 



SINT 



DMINTR 

DMSTOD 

DIMACH 







EWSET 

INTDY 

PREPJ 







SOLSY 

XERRWV 

STODE 

VNORM 



CFODE 







STODE 


DAXPY 







DGBFA 

DGBSL 








DGEFA 

DGESL 

DDOT 







DGBSL 

DGESL 

DGBFA 




DAXPY 

DSCAL 

IDAMAX 

PREPJ 


DGBSL 




DAXPY 

DDOT 


SOLSY 


DGEFA 




DAXPY 

DSCAL 

IDAMAX 

DMPJAC 

PREPJ 

DGESL 




DAXPY 

DDOT 


SOLSY 


DSCAL 







DGBFA 

DGEFA 

DIMACH 







LSODE 


EWSET 







LSODE 


IDAMAX 







DGBFA 

DGEFA 

INTDY 

COND 

GEAR9 

LS0001 

XERRWV 



MAIN 

LSODE 


LTUS 

VELDOT 

ODECON 

OPTS1 






PREPJ [PJAC] 

COND 

LS0001 


DIFFUN 

PEDERV 

DGBFA 

STODE 






DGEFA 

VNORM 




RSCOM 

EH0001 

LS0001 







SOLSY [SLVS] 

LS0001 



DGBSL 

DGESL 


DMSTOD 

STODE 

STODE 

COND 

DIRECT 

GEAR9 

DIFFUN 

PEDERV 

CFODE 

LSODE 



LS0001 

VELDOT 

ODECON 

OPTS1 

PREPJ 

SOLSY 

VNORM 



SVCOM 

EH0001 

LS0001 
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TABLE 9.2. — Concluded. 


Subprogram Common blocks used Subprograms called and referenced Calling subprograms 

[Dummy proce- 
dure name] 

(Entry names) 

VNORM LSODE PREPJ 

STODE 

XERRWV EH0001 DMACHK DMINTR 

DMSTOD LSODE 
INTDY 

XSETF EH0001 

XSETUN EH0001 

BLOCK DATA DIRECT EH0001 KOUT1 

LS0001 LTUS NECC 

OPTS1 REAC1 SPEC1 

TCOF2 TSTNOS 


TABLE 9.3 — COMMON BLOCKS WITH VARIABLES AND SUBPROGRAMS 


Common block 

Variables (dimension) 

Subprograms where used 

AFUN 

LSUBM ETA D VISC BETA SHOCK 

CUBS KINP OUT1 OUT2 SPOUT 

COND 

SIGMA(50) T RHO V DVAR AREA MDOT P IV AR LS 
LSP1 LSP2LSP3 NEXT FLPROB 

MAIN COMB CUBS DIFFUN ELEMNT 
EQLBRM GAUSS HETRAN INIT KINP 
MATRIX OUT1 OUT2 PEDERV RKTOUT 
RXNTAB SHOCKS SHOK SPOUT THRM TINP 
WSOUT WSR SENDDM DFDP SENSIN LSODE 
INTDY PREPJ STODE 

CUBASV 

CUBX(IOO) CUBY(IOO) CUBM(IOO) CN(4) NTB ITPSZ 

iprcod 

DIFFUN KINP OUT1 SPOUT 

CUBTMP 

CUBXT(IOO) CUBYT(IOO) CUBMT(IOO) CNTMP(4) NTTB 
ITTSZ 1TRCOD 

DIFFUN KINP OUT! TINP 

DFDPA 

DFDPJ(52,750) 

SENDDM DFDP DMSTOD 

DIRCT2 

NFIRST LSCALL 

SENDDM DMSTOD 

DIRECT 

DMHO DMELU(13) JDMOPT JDMJAC JSTRDM JDMJEV 
JDMADD JDMDEV IDIRC2 NDMSEN IDMNOR IDMJAC 
IDMY2 JDMIA NRSTOT NISTOT NSTDM NFEDM 
NJEDM 

MAIN SENDDM DMACHK DMINIT DMINTR 
DMPRNT DMSTOD SNSOUT SNSPSC LSODE 
STODE BLOCK DATA 

EH0001 

MESFLG LUNIT 

DMPRNT RSCOM SVCOM XERRWV XSETF 
XSETUN BLOCK DATA 

ELMNTS 

ELNAM(15) 

KINP 

FAIR1 

FUEL 

INIT KINP 

FAIR2 

SCC SCH SCOX ERATIO NOXRAT FLAIR ARAT CRAT 
AIRMW FR02 

INIT OUT1 

GEAR9 

HUSED NQUSED NSTEP NFE NJE VN PD VAR TDVAR 

MAIN OUT2 INTDY STODE 
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TABLE 9.3. — Continued. 


Common block 

Variables (dimension) 

Subprograms where used 

GHSC 

DLTX TXR GRT(50) HRT(50) SR(50) CPR(50) DCPR(50) 

DIFFUN EQLBRM HETRAN KINP MATRIX OUT1 
OUT2 PEDERV SHOCKS SPOUT THRM WSR 
DFDP SNSOUT SNSPSC 

INDX 

NLM IQ1 IQ2 IQ3 KMAT IMAT COMBUS HP TP 
CONVG 

COMB ELEMNT EQLBRM GAUSS KINP 
MATRIX SHOCKS SPOUT WSR 

INERT 1 

DISNM(50) 

KINP 

INERT2 

NINERT 

KINP OUTI OUT2 

KOUT1 

UNIT TITLE(20) UNITI UNITO FPS SI CGS 

KINP OUTI OUT2 SPOUT TINP WSOUT 
BLOCK DATA 

KOUT2 

CON C EXCHR DELH(250) DBUGO 

KINP OUTI OUT2 WSR 

LS0001 

ROWND CONIT CRATE EL(13) ELCO(13,12) HOLD RC 
RMAX TESCO(3,12) ELO H HMIN HMXI HU TN 
UROUND ILLIN IN IT LYH LEWT LACOR LSAVF 
LWM LIWM MX STEP MXHNIL NHNIL NTREP 
NSLAST NYH IALTH IPUP LMAX MEO NQNYH 
NSTEPJ EER JSTART KJFLAG L METH MITER 
MAXORD N NQ NST NFE NJE NQU 

MAIN DMINIT DMINTR DMSTOD SNSOUT 
SNSPSC LSODE INTDY PREPJ RSCOM SOLSY 
STODE SVCOM BLOCK DATA 

LS0002 

HINIT HMAX HMIN MAXORD 
MX STEP MXHNIL 

MAIN KINP OUTI 

LTUS 

LTHM LREAD L WRITE LDAT LTRAP LSCR NTHRD 
NBLANK NPHOTO 

MAIN CIMAGE COMB CUBS DIFFUN 
EQLBRM HETRAN INIT KINP OUTI OUT2 
PEDERV RKTOUT RXNTAB SHOCKS SHOK 
SPOUT THRM TINP WSOUT WSR SENSIN 
SNSOUT SNSTAB INTDY BLOCK DATA 

MATX 

GA(51 ,52) GX{5 1 ) 

EQLBRM GAUSS MATRIX 
PEDERV WSR 

MISC 

TT HRO ENN SUMN ENNL PP CPRO ELNO(15) NITER 

MAIN COMB ELEMNT EQLBRM KINP 
MATRIX SHOCKS SHOK SPOUT WSOUT WSR 

NECC 

SSUM MIX MW RATM M2 GAMMA TCPR RERG RCAL 

MAIN COMB DIFFUN EQLBRM HETRAN INIT 
KINP MATRIX OUTI OUT2 PEDERV SHOCKS 
SHOK SPOUT WSOUT WSR DFDP SNSOUT 
SNSPSC BLOCK DATA 

ODECON 

NRS NRSP1 NRSP2 NS ODE NSODP1 NTEQ NRHEQ 
NVEQ NODES SKIPTR TREQD RHREQD NOJTRH 
VREQD 

MAIN DIFFUN INIT KINP 

OUTI OUT2 PEDERV RXNTAB WSR DFDP 

SENSIN SNSPSC INTDY STODE 

OPTS1 

VERSI TIMEV VERSA AREAV 

DIFFUN HETRAN INIT KINP OUT! OUT2 
PEDERV RXNTAB TINP INTDY STODE 
BLOCK DATA 

OPTS2 

RHOCON TASS RXORDR ACONST PCONST TGIVEN 
TCONST 

MAIN COMB DIFFUN EQLBRM INIT KINP 
MATRIX OUTI OUT2 PEDERV SPOUT TINP 
DFDP SENSIN SNSOUT 

PDDTRM 

PDDSIG(50) PDDT PDDRHO PDDV 

HETRAN KINP PEDERV 

POINTS 

PMLOG DLVTP DLVPT HSUM CCPR GAMMAF WM 

COMB EQLBRM MATRIX SHOCKS SHOK 
SPOUT 
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TABLE 9.3. — Continued. 


Common block 

Variables (dimension) 

Subprograms where used 

PRIN 

CPRINT(IOO) NPRNTS CEND PST AT PASSV PTEMP 
IPRINT 

MAIN KINP OUT1 TINP SENDDM DMINIT 
DMSTOD SNSOUT SNSPSC 

PRIN2 

APRINT(IOO) PRINT(IOO) END 

KINP TINP 

PROP 

EIN EOUT VOLUME SI SF RHOI GAMI WM DELMD 
DELT MASS MPR DOTMAX TMPMIN DTMAX RITE 
WSFLOW WELSTR WSRHTR 

MAIN DIFFUN KINP OUT I OUT2 PEDERV 
WSOUT WSR 

RATLOG 

DAFLOG(250) 

DIFFUN KINP 

REAC1 

EQUAL 

KINP OUT1 BLOCK DATA 

REAC2 

LSR(4,250) XX(250) DPX(2,250) MM(35) RATE(250) 
BRATE(250) LR LRTYPE(250) LR3RD(35) NS3RD(35) 
I3RD(IO,35) 

DIFFUN KINP OUT1 OUT2 PEDERV RXNTAB 
WSR SENSIN 

RMTHOK 

RMFINE THFINE 

KINP 

ROKET 

PC ATHROT ROCKET 

KINP OUT I OUT2 RKTOUT 

RRAT 

A(250) N(250) EACT(250) M(10,35) NUM(250) NTBR 
ALLMI 

DIFFUN KINP OUT I PEDERV DFDP SNSOUT 
SNSPSC 

SABS 

SI AA BB S2 DTERM TTERM DA DT MWARN 

DIFFUN KINP OUT2 PEDERV TINP DFDP 

SAVRAT 

FF(53) 

MAIN INIT OUT2 DMSTOD SNSPSC 

SAVTMP 

XTB(IOO) TTB(IOO) TMPTB(IOO) CX(4) CT(4) 
TPRINT(iOO) 

TINP 

SAVVAR 

CXTB(IOO) CATB(IOO) CXTTB(IOO) CTMPTB(tOO) 
EPRSAV(4) ITRSAV(2) HT(5) WSRHT(5) ACON PCON 
TCON 

KINP OUT1 TINP 

SENNAM 

SNAMES(2,53) 

OUT1 SENSIN SNSOUT SNSTAB 

SENNOR 

SIVNP(52) SRPNP(3) YINV(52) 

MAIN OUT1 SNSOUT SNSPSC 

SENPAR 

SCIV(53,52) SCRP(5 3,250,3) NPARR(3) IDPAR(2,52) 
NREAC(250) NRPOUT 

MAIN OUT1 RXNTAB SENDDM DFDP 
DMACHK DMINIT DMINTR DMSTOD SENSIN 
SNSOUT SNSPSC SNSTAB 

SENSOL 

DYDY0(52,52) SENSE(53,250,3) 

SENDDM DMINTR SNSOUT SNSPSC SNSTAB 

SENVAR 

TINY SENCAL SENSIV SENSRP SENSAJ SENSNJ 
SENSE) SENSTD SENP SENOUT SNORDR 

MAIN KINP OUT1 DFDP DMINTR SENSIN 
SNSOUT SNSPSC SNSTAB 

SINT 

TKSAVE EMAX ATOLSP MF MAXSTP NH AVH 
MMHG MOLEF 

MAIN DIFFUN INIT KINP 

OUT1 OUT2 SNSOUT SNSPSC LSODE 

SPCONC 

C(50) CSUM 

DIFFUN OUT2 PEDERV 

SPECES 

EN(50) ENLN(50) DELN(50) ELSP( 15,50) 

COMB ELEMNT EQLBRM KINP MATRIX 
SHOCKS SHOK SPOUT WSR 

SPEC1 

DSNAM(3) DSPNM(50) EFFM BLANK HNU TAPEND 
TBSPNM(!0,35) 

HETRAN INIT KINP OUT1 OUT2 RXNTAB 
SPOUT WSOUT WSR SENSIN BLOCK DATA 

SPEC2 

MW(50) W(50) STOIC(50,250) OMEGA(50,250) 

DIFFUN HETRAN INIT KINP OUT2 RXNTAB 
WSOUT WSR DFDP 


18 







9*2 Control 


TABLE 9.3. — Concluded. 


Common block 

Variables (dimension) 

Subprograms where used 

STCS 

NSTOIC(4,250) NSPRP(2,250) 

DIFFUN KINP OUT1 PEDERV 

TCOF 

TC(50,7,2) TLOW TMID THI TPREV 

KINP PEDERV THRM 

TCOF2 

THCX(5) THDCX(3) THHCX(5) THSCX(5) KTHRM 

PEDERV THRM BLOCK DATA 

TRAN 

DD HTRAN TWALL TOTMAS PQMRHO PQMT QDOTM 
OTTO STROKE RPM BORE QMREAD HTC(5) 

WSHTC(5) NTR VTC(4,50,2) ICV(50) VCSP(50,2) FDSQ2 
IH20 KOUNT 

DIFFUN HETRAN KINP OUTI OUT2 PEDERV 
WSOUT WSR 

TRAN2 

GAMM1 GM1DG 

DIFFUN HETRAN PEDERV 

TSTNOS 

SMEST TESTNO NLMAX LSMAX LRMAX LSRMAX 
TBRMAX TBSMAX NTBMAX NPMAX 

KINP TINP SNSOUT SNSPSC 
BLOCK DATA 

VELDOT 

TOLD VDOT 

INTDY STODE 

XVSA1 

XU AU(2) 

KINP OUTI 

XVSA2 

XTB(IOO) ATB(IOO) CX(4) 

KINP OUTI 

XVSTI 

XTU TU 

OUTI TINP 

XVST2 

XTTB(IOO) TMPTB(IOO) CTMP(4) 

KINP OUTI TINP 

ZERCON 

FBRATE(2,250) LZEROC 

DIFFUN PEDERV 


set the common blocks are listed alphabetically. The com- 
mon block list is followed by equivalence statements, if any, 
and then by any namelists. Within each namelist the vari- 
ables are ordered alphabetically. However, the namelists 
themselves are listed in the order in which they are read. 
Following the namelists are DATA statements for local vari- 
ables and finally any functions that are internal to the rou- 
tine. 

The remainder of this chapter describes the code. To 
facilitate description of the many functions and options built 
into it, we separate the code into seven major sections, where 
each section performs a different task. These sections are as 
follows: control, input/output, numerical integration proce- 
dure, sensitivity analysis, chemical equilibrium computa- 
tions, incident shock computations, and perfectly stirred re- 
actor computations. In addition, thermodynamic properties, 
heat transfer rates, and transport properties are computed in 
separate sections, by using the procedures described in chap- 
ter 8. 

For each of the seven sections we first describe its func- 
tion and then, because they have already been described in 
table 9.1, only list the subprograms used. The discussion is 
focused mainly on the special features and built-in options. 
However, we provide detailed flowcharts to explain the com- 
putational procedures; in addition, structural diagrams are 


given for each section. We conclude this chapter with a brief 
discussion of the error messages included in the code. 

9.2 Control 

The control section consists of the MAIN program and, as 
discussed in later sections, to some extent the subroutines 
COMB, SHOK, SENDDM, and LSODE. The MAIN pro- 
gram provides for problem setup through a series of subrou- 
tine calls. It calls for input and output of the reaction mecha- 
nism and other problem options. It also calls the appropriate 
subroutine, WSR or SENDDM, depending on the problem 
type — perfectly stirred reactor (PSR) or kinetics/sensitivity 
analysis. For the latter type of problem the MAIN program 
also manages the calls for solution output and computes and 
prints the CPU times. 

The structure of the LSENS code is given in figure 9.1, 
wherein a line connecting two routines indicates that the 
lower routine is called by the upper one and the names in pa- 
rentheses are ENTRY names. This notation is used in all the 
structural diagrams presented in this chapter. The dashed 
lines connecting the routine LSODE with XERRWV and 
DMINTR indicate that other routines not shown in this fig- 
ure are also called by LSODE. We do not include the other 
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9. Code Organization and Description 



Figure 9.1. — Structure of LSENS code. 


routines here because we take up the structure of the LSODE 
package in a later section (9.4). Figure 9.1 gives all the rou- 
tines called by SENDDM because it provides some control of 
the integration. The subroutines called by DIFFUN are also 
included because of its importance. 

A detailed flowchart of the MAIN program is given in Fig- 
ure 9.2. An important feature of LSENS is its capability to 
perform multiple cases in a single run. This option is most 


useful when several runs have to be made with the same 
reaction mechanism but with different problem types or ini- 
tial conditions. Another option that controls the integration 
concerns the printout of results. The solution is generated 
either at intervals of a prescribed number of integration steps 
or at the output stations £out,i>£out,2>*--> where E, is the 
integration variable (i.e., the independent variable for the 
ODE’s). 
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9 3 Input/Output 



9.3 Input/Output 

The input/output section is called for all problem types. It 
reads, processes, and checks the legality of all initial 
conditions and all input data, except those concerned with 
sensitivity analysis. It also prints all input data and initial 
conditions and prints and checks the validity of solutions 
generated by the numerical integration method. In addition, 


an option is available to tabulate and print reaction numbers 
in the order of decreasing importance for each species and to 
print all nonzero production rates of every species by each 
reaction. The subprograms that make up this section are 
CIMAGE, INIT, KINP, OUT1, OUT2, RKTOUT, RXNTAB, 
TINP, and BLOCK DATA. The routines related to output for 
sensitivity analysis, equilibrium, incident shock, and PSR 
calculations are considered in later sections. 
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9. Code Organization and Description 

The most important subroutine in this section is KINP, 
whose structure and flowchart are given in figures 9.3 and 
9.4, respectively. This subroutine initializes various param- 
eters, sets standard options, and reads all options and input 
data, except those specified for sensitivity analysis and the 
temperature profile for an assigned-temperature problem. 
The code has built-in standard choices for many of its op- 
tions to minimize the amount of input data required. For the 
same reason, for a repeat case most of the data specified for 
the previous problem are saved. 

For an assigned-temperature problem KINP calls TINP to 
process the temperature profile and other optional inputs. 
For example, LSENS includes an option whereby output can 
be required at specified values of the temperature, if it is 
assigned in tabular form as a monotonic function of the inte- 
gration variable. In this situation TINP calls CUBS to com- 
pute corresponding values of the integration variable. 

Another option that is included in KINP is that the rate 
coefficient for any third-body collisional reaction may be 
adjusted to account for the different efficiencies of different 
third-body species. The standard choice, which is automati- 
cally set in KINP, is a collisional efficiency of unity. Thus 
only collisional efficiencies that are different from unity need 
to be specified. For each third-body reaction KINP builds up 
a table of third-body species and their collisional efficiencies 
that are different from unity. Any species for which an effi- 
ciency value of unity is given is deleted from this table. 



Figure 9.3. — Structure of subroutine KINP. 


KINP automatically builds up lists of reacting species and 
their constituent elements (atoms, etc.) as it processes each 
reaction. Therefore the user need not specify separate lists of 
elements and reacting species. A list of inert species is, how- 
ever, required. Also in specifying third-body species names 
there is no requirement that this species has already appeared 
in a reaction. However, after all reactions and inert species 
names have been processed, the routine verifies that every 
third-body species has indeed appeared either as a reacting or 
an inert species. In addition, the routine checks that the user 
has not specified a noncatalytic reacting species as inert. 

KINP also confirms that third-body efficiencies have been 
specified only for a third-body reaction and that the effi- 
ciency list follows the reaction. If the list is inserted before 
the reaction, the routine will give an error message and stop 
execution. However, if a third-body reaction precedes the 
one for which the list is intended, such testing is impossible, 
unless a third-body efficiency list had already been processed 
for it. 

KINP includes an option to check the legality of the reac- 
tion mechanism. When this option is selected, the code veri- 
fies that no reaction is duplicated and that each reaction satis- 
fies charge and atom balance requirements. For example, 
reaction duplication may arise because the same reaction is 
written in different forms in different regions of the input file. 
However, we feel that such testing, which adds to the 
expense of running the code, is only necessary when the user 
is either developing or preparing a new mechanism. For this 
reason we have made it optional, and for a repeat case that 
uses exactly the same mechanism as the previous case the 
option is switched off by KINP (even if it had been selected 
for the previous problem). However, in order to avoid an 
error exit for apparently inexplicable reasons, for each repeat 
case KINP checks that the formerly specified mechanism was 
legal. If, for any reason it had been found to be illegal, a 
message stating this fact is printed and the execution is 
halted. 

The same two actions (i.e., printing an error message and 
terminating execution) are taken by KINP for a repeat case if 
either illegal or insufficient thermodynamic data had been 
supplied for the previous problem. 

The final test of the reaction mechanism ensures that no 
superfluous reaction has been included. Such a condition 
arises when some reactions contain species that can neither 
be formed nor destroyed by the mechanism and so will 
always have forward and reverse (and hence net) rates of 
zero. An example is the modeling of the H2-O2 system with 
an H2-O2-N2 mechanism. This problem may also arise be- 
cause some elements of reacting or inert species have not 
been initialized (to a nonzero concentration). The error is not 
considered fatal; a message describing the problem will be 
printed, but the execution will not be terminated. 

Following this testing of the reaction mechanism, KINP 
identifies the problem type, checks the legality and suffi- 
ciency of all input data, and converts them to internal (cgs) 
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Figure 9.4. — Flowchart of subroutine KINP. 














9. Code Organization and Description 

units. A choice of three systems of units, cgs, U.S. custom- 
ary, and SI, is provided for both input and output. The 
choices for input and output units are independent of one 
another, so that either the same or different units for input 
and output can be selected. Output may be required at speci- 
fied values of the assigned variable (pressure or area) if it is 
given in tabular form as a monotonic function of the integra- 
tion variable. In such a case KINP calls CUBS to compute 
corresponding values of the integration variable. 

An important function of KINP is that for a kinetics-only 
problem (i.e., no sensitivity analysis) it sets the number N of 
ODE’s that must be solved. The ODE set contains ODE’s 
for only those variables that are required for a given problem 
and vary during the course of the integration. Thus we do 
not solve ODE’s for variables that are not required (e.g., 
velocity for a static problem), that are specified (e.g., tem- 
perature for an assigned-temperature problem), and that are 
constant (e.g., inert species mole numbers). The ODE set 
therefore contains the minimum number of ODE’s required 
to solve the problem. Not including the preceding variables 
increases the efficiency of the ODE solution for two reasons: 
(1) it avoids unnecessary calculations of derivatives and Ja- 
cobian matrix elements and (2) the system is smaller, thereby 
decreasing the cost of both lower-upper (LU)-decomposing 
(e.g., ref. 6) the iteration matrix (see eq. (9.3)) and solving 
for the corrections at each iteration. 

If sensitivity analysis is required, KINP calls the routine 
SENSIN, which processes all options and input data relevant 
to sensitivity analysis and is described in section 9.5. 

Finally KINP processes the initial conditions and, if nec- 
essary, converts them to internal (cgs) units. It also checks 
the legality and sufficiency of the initial conditions. More- 
over, it checks that the problem is not overspecified. If a 
chemical equilibrium computation is required, KINP calls 
subroutine COMB, which manages such calculations. If 
postshock conditions are required, KINP calls subroutine 
SHOK, which manages these calculations. 


9.4 Numerical Integration Procedure 

LSENS uses the double-precision version (dated June 17, 
1980) of the packaged code LSODE (refs. 20 to 22) to solve 
the stiff ODE’s arising in combustion chemistry. LSODE 
includes a variable-step, variable-order implicit Adams 
method (suitable for nonstiff problems) of orders 1 to 12 and 
a variable-step, variable-order backward differentiation for- 
mula method (suitable for stiff problems) of orders 1 to 5. 
The user may, however, specify a smaller value than used in 
the code for the maximum order to be attempted on any step. 

Irrespective of the solution method the code starts the in- 
tegration with a first-order method and, as the integration 
proceeds, automatically adjusts the method order (and step 
size) for optimal efficiency while satisfying prescribed 


accuracy requirements. Both integration methods employ a 
predictor-corrector scheme, wherein on each step [% n -\ ,£„] 
an initial guess for the solution vector Xn at \ n is first 
produced and then the guess is improved upon by iteration. 
That is, improved estimates X^ m] (m = 1,2,...) are computed 
until the iteration converges. A standard explicit predictor 
formula, a Taylor series expansion method devised by 
Nordsieck (ref. 24), is used to generate Xi 0 ^ A range of 
iteration techniques for correcting this estimate is included in 
LSODE. Both the basic integration method and the corrector 
iteration technique are selected by means of the method flag 
MF. By definition, MF has the two decimal digits METH 
and MITER, and 

MF = 1 OxMETH + MITER (9.1) 

In this equation the integers METH and MITER indicate, 
respectively, the integration method and the corrector itera- 
tion technique to be used for the problem. Table 9.4 summa- 
rizes the integration methods included in LSODE and the 
appropriate values for METH. The legal values for MITER 
and their meanings are given in table 9.5. The Jacobian 
matrix J referred to in this table is an NxN matrix, with ele- 
ment Jfj defined as 

Jjj - dfj/dyj, i,j = (9.2) 


TABLE 9.4.— SUMMARY OF INTEGRATION METHODS 
INCLUDED IN LSODE AND CORRESPONDING 
VALUES OF METH 


METH 

Integration method 

1 

Variable-step, variable-order implicit Adams method 


of orders 1 to 12 

2 

Variable-step, variable- order implicit backward 


differentiation formula method of orders 1 to 5 


TABLE 9.5.— CORRECTOR ITERATION TECHNIQUES 
AVAILABLE IN LSODE AND CORRESPONDING 
VALUES OF MITER 


MITER 

Corrector iteration technique 

0 

Functional iteration 

1 

Modified Newton iteration with user-supplied analytical 
Jacobian matrix 

2 

Modified Newton iteration with internally generated 
numerical Jacobian matrix 

3 

Modified Jacobi-Newton iteration with internally 
generated numerical Jacobian matrix 

a.b 4 

Modified Newton iteration with user-supplied banded 
Jacobian matrix 

a 5 

Modified Newton iteration with internally generated 
banded Jacobian matrix 


a The user must supply the lower (ML) and upper (MU) half-bandwidths 
of the Jacobian matrix (ref. 22). 

b This option should not be used with the present version of LSENS. 
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where y/ is the ith ( i = 1,...,A) dependent variable and 
fi = dy/dt,. 

The LSODE package consists of the main core integration 
routine, also called LSODE, and the 21 subprograms 
CFODE, DAXPY, DDOT, DGBFA, DGBSL, DGEFA, 
DGESL, DSCAL, D1MACH, EWSET, ID AM AX, INTDY, 
PREPJ, RSCOM, SOLSY, STODE, SVCOM, VNORM, 
XERRWV, XSETF, and XSETUN. Of these subprograms 
LSENS makes no use of the routines RSCOM, SVCOM, 
XSETF, and XSETUN. The structure of the LSODE pack- 
age is given in figure 9.5, wherein the dashed lines indicate 
the modifications made to this code to compute sensitivities 
and the names in brackets are dummy procedure names. 

The main routine LSODE controls the integration and 
serves as an interface between the calling subprogram and 
the rest of the package. Its flowchart is given in figure 9.6, 
where ITASK and ISTATE are user-supplied indices that 
specify, respectively, the task to be performed and the state 
of the calculation, that is, if the call to LSODE is the first 



Figure 9.5.— Structure of LSODE package (adapted from reference 22). 


9.4 Numerical Integration Procedure 

one for the problem or if it is a continuation (ref. 22). It must 
be pointed out that the figure shows only those LSODE op- 
tions used by LSENS. On return from LSODE the value of 
ISTATE indicates if the integration was performed success- 
fully, and if not, the reason for failure. The variable TOUT is 
the next i; value at which output is required. Finally JSTART 
is an internally defined variable used for communicating the 
state of the calculation with subroutine STODE. 

An important feature of LSODE is that it will compute the 
step size to be attempted on the first step if the user chooses 
not to provide a value for it. Another useful feature is that 
different integration methods can be used in different slib- 
intervals of the problem. For example, the heat release pe- 
riod, especially the early part, is not stiff (refs. 25 to 30), and 
it may be more efficient to switch to a nonstiff method in this 
regime (ref. 31). The code LSENS does not exploit this fea- 
ture because of the lack of reliable regime identification tests, 
and the same method is used for the whole problem. 

The routine STODE advances the solution to the ODE’s by a 
single integration step. In addition, it computes the method order 
and the step size that together maximize efficiency while main- 
taining prescribed accuracy. To increase the efficiency of the cal- 
culation procedure, the solution history, which is required by the 
multistep methods used in LSODE (ref. 22), is saved in the form 
suggested by Nordsieck (ref. 24). The Nx(q n + 1) Nordsieck 
history matrix z n -\ at ^ n -\ contains the numerical solution 
Y„-i and the q n scaled derivatives \fj* (j = 1 . •••>?«). 

where h n (= - £„-i) and q n are the current step size and 

method order, respectively, and = d^XJdi^ . The flow- 
chart of STODE, again as used by LSENS, is presented in 
figure 9.7, which essentially illustrates how the history ma- 
trix is advanced over the step i&J. In this figure NCF 
is the number of corrector convergence failures on the current 
step, KFLAG is an internally defined flag used for communi- 
cation with subroutine LSODE, zj^ is the predicted history 
matrix at and P, an NxN iteration matrix that arises from 
Newton iteration, is given by 

P = I - (9.3) 


where I is the NxN identity matrix and Pq is a method coef- 
ficient that depends on the integration method and the 
method order (ref. 22). The vector £ contains the integration 
method coefficients, and £q (= Po) is the zeroth component of 
£ . The integer counter IALTH indicates how many more 
steps are to be taken with the current step size H and method 
order NQ, and HMIN and HMAX are user-supplied mini- 
mum and maximum absolute values of the step size to be at- 
tempted on any step. The ratios RHDN, RHSM, and RHUP 
are factors by which H can be increased if the new method 
order is NQ - 1 , NQ (the current value), and NQ + 1 , respec- 
tively. R is the ratio of the step size to be attempted next to its 
current value, and RMAX is the maximum R allowed when a 
step size change is next considered. Finally NQMAX is the 


25 






(Start ) 



Figure 9.6.— Flowchart of subroutine LSODE, as used by LSENS (adapted from reference 22). 
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Figure 9.7. — Flowchart of subroutine STODE, as used by LSENS (from reference 22). 


27 


























Figure 9,8. — Flowchart of subroutine DIFFUN. 
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9.5 Sensitivity Analysis 



Figure 9.9. — Flowchart of subroutine PEDERV. 


maximum method order that may be attempted on any step, 
and £* (= h n - h n Yj 0 ^) is proportional to the local trunca- 
tion error vector. 

The two user-supplied routines used by the integrator are 
DIFFUN, which computes the derivatives, and PEDERV, 
which computes the Jacobian matrix. The structure of 
DIFFUN is given in figure 9.1 . Flowcharts for DIFFUN and 
PEDERV are presented in figures 9.8 and 9.9, respectively. 
In these figures p and V are the mixture density and velocity. 
To maintain the accuracy of the Jacobian matrix and to pre- 
vent overflow errors, PEDERV checks for species with zero 
concentration and includes special calculation procedures for 
such a situation. 


9.5 Sensitivity Analysis 

For any static reaction problem the first-order sensitivity 
coefficients {S tJ (= 3f//3r| y )} can be computed. Here is 
the numerical solution for the ith (i = 1,...,/V) dependent vari- 
able, and r|j is either an initial condition value or a rate coef- 
ficient parameter (i.e., Aj, nj, Ej, or cy, see eqs. (8.3) and 
(8.4)). The sensitivity analysis computations use the 
decoupled direct method (refs. 30, 32, and 33), as imple- 
mented by Dunker (ref. 34) for isothermal problems and ex- 
tended by Radhakrishnan (ref. 33) to nonisothermal combus- 
tion kinetics. An important feature of LSENS is that it can 
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9. Code Organization and Description 

be used to generate any number of sensitivity coefficients, 
from just one initial condition or one rate coefficient param- 
eter of one reaction to the full set of all TV initial conditions 
and all 3NR rate coefficient parameters, where NR is the 
total number of reactions. Finally the linear sensitivity coef- 
ficients of the temporal derivatives of the dependent vari- 
ables (i.e., {3F/dr|y}) can also be computed. 

This section of the program reads, processes, and checks 
the legality of all input data, solves for the sensitivity coeffi- 
cients, and normalizes and prints them when output is 
required. Provision is made for the user to specify a cutoff 
level, TINY, for the normalized sensitivity coefficients. Any 
normalized sensitivity coefficient that is smaller in magni- 


tude than TINY is set equal to zero. For rate coefficient 
parameters an option to tabulate and print nonzero normal- 
ized sensitivity coefficients in decreasing magnitude is pro- 
vided. The list is produced for each dependent variable. The 
corresponding reaction number is placed above each normal- 
ized sensitivity coefficient. Thus the user has the convenient 
option of obtaining a list of reaction numbers in order of 
decreasing importance for each variable. Finally, if required, 
this section computes, normalizes, prints, and if necessary, 
tabulates in order of decreasing importance, the sensitivity 
coefficients of the temporal derivatives of the variables. 

The 12 subroutines that make up this section are 
SENDDM, DFDP, DMACHK, DMINIT, DMINTR, 



Figure 9.10. — Flowchart of subroutine SENDDM. 
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9.5 Sensitivity Analysis 


DMPJAC, DMPRNT, DMSTOD, SENSIN, SNSOUT, 
SNSPSC, and SNSTAB. Among these, six routines 
(SENDDM, DMACHK, DMINIT, DMPJAC, DMPRNT, and 
DMSTOD) were adapted from the May 1984 version of the 
code CHEMDDM (ref. 34). Other subprograms that are 
required for sensitivity analysis include DIFFUN, PEDERV, 
DAXPY, DDOT, DGEFA, DGESL, DSCAL, IDAMAX, 
SOLSY, XERRWV, and those used by DIFFUN. 

Besides reading, processing, and checking the legality of 
all input, SENSIN sets the number of ODE’s to be solved. In 
addition to the ODE’s for nonconstant quantities SENSIN 
examines the initial condition parameters with respect to 
which sensitivities are required. For example, if sensitivity 
coefficients with respect to the initial temperature are 
required, the Jacobian matrix elements of all variables with 
respect to the temperature must be computed. Therefore, 
even if the temperature is constant, the routine includes it in 
the ODE list. Similar remarks apply to the density and inert 
species mole numbers. 

The main subprogram in this section of the code is 
SENDDM, whose structure and flowchart are given in figures 
9.1 and 9.10, respectively. The internally defined integer 
variable ICALL in figure 9.10 denotes if the call to 
SENDDM is the first one for the problem or a continuation. 
This routine sets the sensitivity arrays at the initial time and 
calls DMACHK, which checks that sufficient storage has 
been allocated for the problem. SENDDM also manages the 
call to LSODE. LSENS includes an option that dictates how 
the integration is to be continued after every printout of the 
solution: either normally, so that LSODE uses past solution 
values in further developing the solution, or by reinitializing 
LSODE so that it effectively solves a new problem after ev- 
ery printout. If the second option is selected, SENDDM calls 
DMINIT to initialize the sensitivity arrays and sets the appro- 
priate index that causes LSODE to reinitialize the integration 
process. 

The routine DMSTOD advances the sensitivity arrays by 
one time step. The integration method used to solve for the 
sensitivities is the backward differentiation formula, as imple- 
mented in LSODE. Predicted values are first generated by 
using the Taylor series expansion method devised by 
Nordsieck (ref. 24). They are then corrected with the back- 
ward differentiation formula method in conjunction with a 
single Newton-Raphson iteration, using an analytical Jaco- 
bian matrix. At each step DMSTOD uses exactly the same 
step size and method order as those used by STODE to inte- 
grate the model problem. As for the model problem the solu- 
tion history for sensitivity coefficients is maintained in the 
Nordsieck history array. Thus for the jXh parameter qy the 
Nx(q n + 1) matrix Z/ >n contains £y >n , the sensitivity coefficient 
vector with respect to r\ y, and its q n scaled derivatives at t n . 

The structure of DMSTOD is shown in figure 9. 11, where 
the dashed lines connect subroutines included in, or required 
by, the LSODE package and the names in brackets are 
dummy procedure names. This figure shows that the only 



additional subprogram needed by the decoupled direct 
method to compute sensitivity coefficients is DFDP. 
DMPJAC is a simplified version of PREPJ (table 9.1). The 
former routine assumes that a specific iteration method 
(Newton-Raphson with a user-supplied analytical Jacobian 
matrix) is used; the latter is more generalized. DMPJAC can 
be replaced with PREPJ, but to do so would reduce the effi- 
ciency marginally. DMINTR is based on INTDY (table 9.1) 
and computes the sensitivities and their derivatives at the 
output stations. 

The flowchart of DMSTOD is presented in figure 9.12, 
which illustrates how the Nordsieck history matrices for the 
sensitivity coefficients are advanced over the step [t n -\>t n ]. 
In this figure Z is the predicted history matrix for the jth 
parameter at t n> P is given by equation (9.3), and the vector 
2^ i ( 1 ) contains the scaled first derivative of 1 
(i.e., h n Sj t n- 1 ). LSENS contains an option that controls how 
often the Jacobian matrix is updated when solving for the 
sensitivity coefficients: either on every step or only on those 
steps for which STODE performed this update for the model 
problem. 
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Figure 9.1 2. — Flowchart of subroutine DMSTOD. 













9.6 Chemical Equilibrium 
Computations 

The code has built-in procedures for computing the equi- 
librium composition for the following four assigned states: 
(1) temperature and pressure (TP), (2) mass-specific enthalpy 
and pressure (HP), (3) temperature and specific volume (TV), 
and (4) mass-specific internal energy and specific volume 
(UV). For cases 2 and 4 the equilibrium temperature is also 
determined. The code automatically performs the appropri- 
ate type of equilibrium calculation, as discussed here. 

The main subprogram in this section is COMB, which 
manages the equilibrium computation, calls for output of 
results, and prints the computational work required. The 
other routines used in this section, whose structure is given in 
figure 9.13, are ELEMNT, EQLBRM, GAUSS, MATRIX, 
SECCPU, SPOUT, and THRM. COMB examines the vari- 
able TCONST, which is set in KINP and indicates whether 
the kinetics problem following the equilibrium calculation 
is at constant temperature, and sets the appropriate switch, 


9.6 Chemical Equilibrium Computations 
TP or HP, to indicate to EQLBRM whether an assigned- 
temperature equilibrium computation is required. It also ini- 
tializes the estimates for the equilibrium mixture composition 
and, if necessary, the equilibrium temperature. 

The equilibrium computations are performed in EQLBRM, 
which was adapted from the code CET (ref. 11). The routine 
selects the equilibrium problem type by examining the 
switches HP, TP, and RHOCON, which indicates if a con- 
stant-density kinetics problem follows the equilibrium com- 
putation. The equilibrium state is obtained by minimizing 
either the Gibbs or Helmholtz function. The resulting alge- 
braic equations are solved by using a descent Newton- 
Raphson iteration method (refs. 10 and 11), which automati- 
cally limits the size of the corrections at each iteration to 
avoid convergence difficulties. Also, to prevent negative 
concentration and temperature, the code solves for the 
logarithm of the variables. A flowchart of the calculation 
procedure is given in figure 9.14, where V, 7, and p are, re- 
spectively, the mixture mass-specific volume, temperature, 
and pressure. 



Figure 9.1 3. — Structure of chemical equilibrium section. 
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Figure 9.14. — Flowchart of equilibrium calculation procedure (subroutine EQLBRM). 















9.7 Incident Shock Computations 

LSENS includes an option to compute the thermodynamic 
state and velocity behind an incident shock. Two types of 
computations are performed. First, the code solves for the 
“equilibrium” shock conditions when the shock-initiated 
reactions have equilibrated. The second calculation pro- 
duces the “frozen” shock conditions immediately after shock 
passage when the composition is unchanged from its initial 
value. 

The main subprogram in this section of the code is SHOK, 
which manages the shock computation, calls for output of 
results, and prints the computational work required. It also 
sets the type of shock computation, equilibrium or frozen, to 
be performed. Figure 9.15 gives the structure of this section, 
which uses the routines ELEMNT, EQLBRM, SECCPU, 
SHOCKS, SPOUT, THRM, and those called by EQLBRM. 

The routine SHOCKS, which was adapted from CET 
(ref. 11), sets initial estimates for both postshock conditions. 
It also computes both states by solving the mass, momen- 
tum, and energy conservation equations. A Newton- 
Raphson iteration procedure, which automatically limits the 



Figure 9.15. — Structure of incident shock section. 


9.7 Incident Shock Computations 
size of the corrections to minimize convergence difficulties, 
is used. In order to avoid negative variables during the solu- 
tion procedure, the equations are cast in terms of the loga- 
rithm of the variables. Figure 9.16 presents the flowchart of 
SHOCKS. In this figure the internally defined logical vari- 
able EQL is used to denote the type of shock calculation, and 
L m is a characteristic shock tube reaction length required for 
the post-shock kinetics problem. After the frozen shock con- 
ditions are successfully computed, L m is calculated by 
SPOUT if the user has not provided a value for it. 

Starting with the frozen shock state the code follows the 
progress of the chemical reaction in the shocked gas by inte- 
grating the ODE’s describing one-dimensional flow with 
assigned area over a prescribed time or distance interval. The 
flow area profile is given by a special function, which cor- 
rects for frictional losses (refs. 35 to 37): 


Mx) = i 

^ ”'-Kr 


(9.4) 


In this equation A(jc) is the area at distance x> A s is the shock 
tube cross-sectional area, L m is a characteristic length, and 
the exponent T| is either 0.5 for a laminar boundary layer or 
0.8 for a turbulent boundary layer. 

The length L m also depends on whether the boundary layer 
is laminar or turbulent. It may be specified by the user or is 
computed by the code as follows (refs. 36 and 37): 


I 



( „ v 

P\ 

loj 

<P2A 


Vj-V 2 



P[ Pst^st 




1-T) 

n 


Pst M-st ) 


(9.5) 


In this equation dn (= 4 A s fL p , where L p is the shock tube 
perimeter) is the shock tube hydraulic diameter; (3 is a bound- 
ary layer thickness parameter; <JX (= Wc, where c is the sonic 
velocity) is the Mach number; p st is a standard pressure, for 
example, 1 atmosphere; and (I is the mixture dynamic viscos- 
ity. The subscripts 1 and 2 refer, respectively, to conditions 
upstream and downstream of the shock, using a coordinate 
system attached to the shock, which is therefore stationary. 
Thus the unshocked gas flows into the shock at velocity V\, 
and the shocked gas flows away from it at velocity V 2 . 
Finally the subscript “st” denotes standard conditions and the 
quantity p s tC s t/j-ist is assumed to be the same as piC|/p.|. 
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Figure 9.16. — Flowchart of incident shock calculation procedure (subroutine SHOCKS). 










9.8 Perfectly Stirred Reactor 
Computations 

Perfectly stirred reactor computations can be performed for 
either a specified mass flow rate or a specified reactor tem- 
perature. In the former case the code solves for the mixture 
composition and temperature at the reactor exit. In the latter 
case the mass flow rate and the reactor exit mixture composi- 
tion are computed. The problem type is identified by exam- 
ining the user input parameters required for problem 
solution, and so a separate switch need not be set. 

The main routine in this program section, whose structure 
is shown in figure 9.17, is WSR. The other routines required 



Figure 9.17. — Structure of perfectly stirred reactor section. 


9.9 Error Messages 

by this section are DIFFUN, ELEMNT, EQLBRM, GAUSS, 
HETRAN, OUT2, PEDERV, SECCPU, THRM, and 
WSOUT. The flowchart of WSR is given in figure 9.18, 
where m , T \ and z r are the mass flow rate, temperature, and 
residence time, respectively. Also rh\ is the mass flow rate 
that is specified for the first solution of an assigned-mass- 
flow-rate problem, and T \ and mo are the prescribed tem- 
perature and mass flow rate to start iteration, respectively, for 
the first solution of an assigned-temperature problem. Finally 
T g q is the equilibrium temperature for the reactor inlet state. 

For both problem types WSR solves the governing nonlin- 
ear algebraic equations by using a Newton-Raphson iteration 
technique, which automatically limits the size of the correc- 
tions to reduce convergence difficulties. Also, to avoid nega- 
tive results, the code solves for the logarithm of the variables. 
Starting with conditions close to the equilibrium state, a 
series of perfectly stirred reactor computations is performed 
until the desired mass flow rate or reactor temperature is 
reached. This technique is used to minimize the possibility 
of convergence to a false solution — one that is mathemati- 
cally correct but physically unrealistic. The routine includes 
several tests and, when necessary, restarts of the calculation 
to ensure that the solution is physically meaningful. Finally 
it includes tests for possible blowout of the chemical reaction 
within the reactor. 


9.9 Error Messages 

The code contains many error messages — too numerous to 
list here. Every input parameter is tested for legality and 
consistency with the other input variables. If an illegal input 
parameter is discovered, a detailed message is printed. Each 
error message is self-explanatory and complete. It not only 
describes the mistake but tells the user how to fix the prob- 
lem. During execution some tests are made to ensure that 
variables are within either given or reasonable bounds. Any 
difficulty encountered during execution will result in an error 
exit. A message giving the reason for the termination and the 
name of the subprogram where the problem occurred will 
also be printed. If the computation stops prematurely, the 
user should look for the error message near the end of the 
output file. 
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Figure 9.18. Flowchart of perfectly stirred reactor calculation procedure (subroutine WSR). 





















Chapter 10 

Code Implementation 

The LSENS package may have to be modified to make it 
compatible with the user’s computer system and computa- 
tional requirements. The modifications are classified into 
two categories, (1) those that must be made before the 
present version of the code can be used and (2) those required 
to enhance the computational capabilities of the code. In this 
chapter we describe the first category of modifications. We 
also discuss certain optional changes that may be made. We 
then list parameters that place restrictions on the size of the 
problem that can be solved with the present version of the 
code. The code adjustments needed to alter the built-in val- 
ues for these parameters (i.e., the second category of modifi- 
cations) are, however, described in appendix C. We conclude 
this chapter with a brief note on restrictions that may have to 
be placed on the optimization level when compiling subrou- 
tine KINP (see table 9.1). 

10.1 Computer Language 

The code is compatible with most FORTRAN 77 compil- 
ers. However, it contains detailed instructions on how 
to convert it to FORTRAN 66, as discussed in chapter 9 
(section 9.1). 

10.2 Suppressing Underflow 
Error Messages 

The MAIN program includes a system call to suppress 
underflow error messages. The form of this call used in the 
present version of LSENS is 

CALL ERRSET (208, 256, -1,1,1) 

where ERRSET is a VS FORTRAN-supported subroutine 
that enables the user to control execution when error condi- 
tions occur. The number 208 is an IBM-designated code for 


underflow. On other systems the call may have to be 
changed or deleted. For example, 

CALL ERRSET (74, .TRUE., FALSE., .FALSE., FALSE.) 
is appropriate for VAX computers. 

10.3 Function SECCPU 

The function SECCPU, which computes the incremental 
central processing unit (CPU) time in seconds (see table 9.1), 
may have to be replaced. This function calls the system 
clock and is given for several common computing systems in 
appendix B. 

10.4 Modifying Subroutine XERRWV 

The routine XERRWV, which prints out error messages 
from the LSODE package and the sensitivity routines 
DMACHK, DMINTR, and DMSTOD (see table 9.1), is 
machine and language dependent. Therefore the data-type 
declaration for the argument MSG, which is a Hollerith lit- 
eral or integer array containing the message to be printed, 
may have to be changed, as described in reference 22. How- 
ever, the routine itself gives the necessary modifications for 
many machine environments. 


10.5 BLOCK DATA Variables 

The next modification concerns the values assigned to the 
variables SMEST, TESTNO, THCX(3), and THDCX(l) in 
the BLOCK DATA module. The double-precision variable 
SMEST (current value, 1 .0D-35) is used in normalizing sen- 
sitivity coefficients. Any dependent variable K/ that is smaller 
in magnitude than SMEST is set equal to SMEST to avoid 
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computational difficulties caused by an excessively small (or 
zero) Yj. The real variable TESTNO (current value, 
-1.0E+35), which is essentially -°o, is the value used to 
initialize several variables, such as the print stations, that is, 
distinct points at which the solution is required. Both SMEST 
and TESTNO may be changed by the user. The double- 
precision variables THCX(3) (= 2/3) and THDCX(l) (= 4/3) 
are used to compute certain thermodynamic properties and 
may be changed to make them consistent with the precision 
of (i.e., number of decimal digits considered by) the machine. 

All logical unit numbers for input and output are also set in 
the BLOCK DATA and may be changed by the user. The 
logical unit numbers used for input are as follows: First, a 
data file containing thermodynamic data for the species must 
be made available on unit LTHM, whose current value is 4. 
Second, data for the user’s problem are read from unit 
LREAD, which is currently 5. This data type includes the 
chemical reaction mechanism, keywords identifying the 
problem to be solved, initial conditions, etc. Thermodynamic 
data may also be included in this file, in which case they are 
copied onto a separate scratch file associated with the logical 
unit LSCR, whose present setting is 9. Subsequently, these 
coefficients are read from unit LSCR. All other data are cop- 
ied onto, and later read from, a separate scratch file, which 
must be made available on the logical unit LDAT, which is 
currently 7. Finally, if transport properties are required for the 
problem, the necessary data are read from the logical unit 
LTRAP (current value, 8). 

Summary information regarding storage and work require- 
ments for sensitivity analysis from the routine DMPRNT and 
all error messages from the routine XERRWV are sent to the 
logical unit LUNIT, which is currently 6. All other output 
information is directed to the logical unit LWRITE, whose 
current value is also 6. 


10.6 Reducing Storage Requirement 

The final code modification concerns computer memory 
requirement. If the sensitivity analysis option is not required 
and computer storage is of concern to the user, the lengths 
LRW and LIW of the real and integer work arrays RWORK 
and IWORK, respectively, may be decreased to the values 
indicated in the code. The dimensions of RWORK and 
IWORK must also be decreased to the values given in the 
code. The storage requirement may be further reduced by 
replacing all sensitivity subroutines except SENDDM (see 


chapter 9) and the common blocks SENNAM, SENNOR, 
SENPAR, and SENSOL with dummy versions or, if allowed 
by the loader, even eliminating them. If SENPAR is either 
deleted or replaced with a dummy version, the EQUIVA- 
LENCE statement in subroutine RXNTAB must be deleted. 

The present version of the code makes no use of the rou- 
tines RSCOM, SVCOM, XSETF, and XSETUN (see 
table 9.1), which may all be deleted if the user intends to use 
LSENS solely as a black box that provides solutions to kinet- 
ics and sensitivity analysis problems. In addition, if the itera- 
tion techniques given by MITER = 4 and MITER = 5 (see 
table 9.5) will not be used, the routines DGBFA and DGBSL 
may be replaced with dummy routines or even eliminated, if 
allowed by the loader. Finally, if parameters related to prob- 
lem size are smaller than the built-in values (see section 
10.7), the modifications described in appendix C may be 
made to decrease the storage requirement. 


10.7 Code Limitations 

The present version of LSENS allows for a maximum 
number of 50 (reacting plus inert) species participating in a 
maximum number of 250 reactions, of which up to 35 may 
be of the third-body collisional type. The maximum number 
of elements (atoms, etc.) that can be used for any problem 
is 15. However, a species may contain no more than four dif- 
ferent elements. For any general third-body reaction, third- 
body collisional efficiencies different from unity can be 
specified for a maximum number of 10 species. As described 
in chapter 1 1, one or more of the three quantities pressure, 
area, and temperature can be specified for the complete prob- 
lem by means of a table of values. If this option is used, up 
to 100 values can be given. Finally, the maximum number of 
print stations is 100. 


10.8 Compiler Optimization Level 

On some computer systems (e.g., Sun SPARCstation 1) the 
size of subroutine KINP may prevent the use of high 
optimization levels. If any compilation difficulty is encoun- 
tered, this subroutine should be compiled separately with a 
reduced optimization level that is acceptable to the system. 
All other subprograms can, however, be compiled with any 
optimization level. 
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Chapter 11 

Description of Code Usage 


Two input data files are normally required to execute the 
code. The first one, which we call the standard thermo- 
dynamic data file, must contain the chemical symbol and 
composition, molar mass, and thermodynamic data for each 
species. The second file, which we call the problem data file, 
must give information about, and data required by, the prob- 
lem (or problems) to be solved. If desired, the user may 
include in this data file thermodynamic data for any species. 
A third input file, containing transport properties data, is 
required for certain computations. This file will be called the 
transport properties data file. 

In this chapter we describe code usage and the input data 
files and provide a guide to their preparation. We first discuss 
the thermodynamic and transport properties data information 
that must be supplied. We then describe the preparation of the 
problem data file for a single case. Finally, we explain the 
construction of the data file required to solve multiple prob- 
lems in a single run. 

11.1 Thermodynamic Data Information 

The thermodynamic data for the species may be supplied 
through the standard thermodynamic data file and/or the 
problem data file. The user informs the code where to get the 
thermodynamic data by means of the keyword TAPE or 
CARD in columns 1 to 4 of the first line of the problem data 
file. If data for all species are to be taken from the standard 
thermodynamic data file, the keyword TAPE must be used. A 
standard file, containing data from the most recent thermody- 
namic data base of the CET code (ref. 11) for many species 
in the C-H-N-O system, is supplied with LSENS. Figure 11.1 
shows the beginning of this file. The first line contains the 
three temperatures TLOW, TMID, and THIGH, which 
together define two temperature ranges (300 to 1000 K and 
1000 to 5000 K in fig. 1 1 . 1 ) for two sets of the seven coeffi- 
cients defined in equations (8.32) to (8.34). The format used 
to read this line is 3F10.3. For each species the data are writ- 
ten in a group of four lines. For convenience each line con- 


tains its number in column 80. The first line contains the 
following identification information: species name, thermo- 
dynamic data source and date when compiled, composition 
and phase of the species, temperature range over which the 
thermodynamic data are valid, and molar mass of the species. 
The format used to read this line is A8, 16X, 4(A2, F3.0), 
21X, E13.6. On the next three lines the coefficients for the 
high-temperature range, followed by those for the low- 
temperature range, are listed. The format used to read these 
lines is 5E15.8, /, 5E15.8, /, 4E15.8. For some species the 
fourth line contains a fifth number, which is the heat of for- 
mation at 25 °C divided by the universal gas constant and has 
units of Kelvin. The end of the standard file is indicated by a 
line containing the word END in columns 1 to 3. 

If thermodynamic data for some (or all) species are to be 
selected from the problem data file, the keyword CARD 
should be used. The thermodynamic data must then be placed 
immediately after the first line. The format for this informa- 
tion is identical to that of the standard thermodynamic data 
file. That is, the second line of the problem data file must 
contain the three temperatures TLOW, TMID, and THIGH. 
Next thermodynamic data must be given for all species for 
which the user wishes to provide this information in the prob- 
lem data file. For each such species, irrespective of the case 
(or cases) in which it appears, the four lines of data described 
previously must be supplied. Finally the end of the thermody- 
namic data is indicated by a line containing the word END in 
columns 1 to 3. 

If data are given for any species in both the standard ther- 
modynamic data file and the problem data file, the latter in- 
formation will be used and the former ignored. Thus the user 
has a convenient way of temporarily changing any thermody- 
namic data or adding new species without modifying the 
standard file. 

The thermodynamic data information, that is, either the 
keyword TAPE or the keyword CARD followed by the re- 
quired data, is given only once, at the beginning of the prob- 
lem data file, irrespective of the number of problems con- 
tained therein. Therefore, if any thermodynamic data are to 
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300.000 1000. 
AR 

0.25000000E 01 
-0. 74537502E 03 0. 
0.00000000 
6R 

0.20843207E 01 0. 
0.12858837E 05.0. 
0. 12262 126E-08-0. 
BR2 

0 . 44479495E 01 0 
0 . 2365994 1 E 04 0 
0.28120689E-08-0 
C 

0.25769424E 01-0 
0.85425220E 05 0 
-0. 18489024E-09 0 
CH 

0.22673116E 01 0 
0. 70838037E 05 0 
0. 18226922E-08-0 
CH2 

0.27525479E 01 0. 
0.45547759E 05 0 
0. 19469445E-08-0 
CH20 

0.28364249E 01 0. 
-0. 1523603 IE 05 0. 
-0. 17869 177E-07 0. 
CH202 

0. 57878771E 01 0. 
-0.48191230E 05-0. 
-0.81816403E-08 0. 
CH3 

0.28400327E 01 
0. 1644981 3E 05 
-0. 18859236E-08 
CH20H 

0.46129885E 01 
-0. 38908596E 04 
-0. 57237202E-08 
CH30 

0. 37590771E 01 
0. 1320808 IE 03 
-0. 74311 082 E - 08 
CH4 

0.21737833E 01 
-0. 10216566E 05 
-0.47495483E-08 0 
CH30H 

0.40334730E 01 
-0.26159859E 05 
-0-876611 14E-08 
CN 

0.36036285E 01 
0.511 59833E 05 . 
-0. 311 13000E-08 0 

CNN 

0.4820907 7E 01 0 
0.68685948E 05-0 
0.42979217E-08-0 
END 


000 5000.000 

L 5/66AR 1.00 0.00 0.00 0.G 
0.00000000 0.00000000 
43660006E 01 0.25000000E 01 
0.00000000-0. 74537498E 03 
J 6/74BR 1. 0. 0. O.G 

71949483E-03-0.27419924E-06 
90838003E 01 0.24611551E 01 
44283510E-12 0.12711920E 05 
J12/61BR 2.0 0.0 0.0 O.G 
. 10051208E-03-0. 16393816E-07 
.4088843 IE 01 0.38469580E 01 
73256202E-12 0.24846984E 04 
J 3/78C 1. 0. 0. O.G 

13903944E-03 0.69481807E-07 
43358122E 01 0.25279476E 01 
57291741 E- 1 3 0.85448374E 05 
J12/67C l.H 1.0 0.0 O.G 

22043000E-02-0. 62250191E-06 
87889352E 01 0.35632752E 01 
8676831 IE-12 0.70405506E 05 
J12/72C l.H 2. 0. O.G 

39782047E-02-0. 14921731E-05 
66534799E 01 0.35883347E 01 
89431394E-12 0.45315188E 05 
J 3/61C l.H 2.0 1.0 O.G 
.68605298E-02-0.26882647E-05 
. 78531 1 69E 01 0.37963783E 01 
. 5650445 I E- 1 1 -0 . 15088947E 05 

1 5/80C l.H 2.0 2. O.G 

. 75539909E-02-0 . 30995161E-05 
. 6529901 5E 01 0.21183796E 01 
. 30133404E- 1 1-0.46669293E 05 

J 6/69C l.H 3.0 0.0 O.G 
. 60869086E-02-0 . 2 1 740338E-05 
.5505675 IE 01 0.34666350E 01 
. 66803 182E- 12 0.16313104E 05 
BUR 84C l.H 3.0 1. O.G 

. 629714 13E-02-0.20029483E-05 
.52852684E 00 0.33168221E 01 
.20724056E- 11 -0.33 14632 IE 04 
L 6/80C l.H 3.0 1. O.G 

. 78945048E-02-0.26710486E-05 
. 29936295E 01 0.21097078E 01 
. 20939578E -11 0.97822803E 03 
L 5/84C l.H 4. 0. O.G 

. 89936592E-02-0. 27855467E-05 
• 70773563E 01 0.29428148E 01 
14244910E-12-0. 10056824E 05 
L 4/80C l.H 4.0 1. O.G 

93680508E-02-0.30449373E-05 
23539820E 01 0.26587849E 01 
23805116E-11-0.25353684E 05 
J 6/69C l.N 1.0 0.0 O.G 

33644390E-03 0.10028933E-06- 
35454505E 01 0.37386307E 01- 
61675318E-12 0.51270927E 05 
J 6/66C l.N 2.00 0.00 O.G 
24790014E-02-0.94644109E-06 
•48484039E 00 0.35077779E 01 
. 94257935E-12 0.68994281E 05 


300.000 5000.000 39.94800 

0.00000000 0.00000000 

0.00000000 0.00000000 

.43660006E 01 0.00000000 

300.000 5000.000 79.909 

. 42422650E- 10-0. 23791570E- 14 
.33319275E-03-0. 10080655E-05 
.69494733E 01 

300.000 5000.000 159.818 

.2268562 IE- 11-0. 10236774E-15 
. 261 1 1841 E-02-0.40034147E-05 
.69696985E 01 

300.000 5000.000 12.01100 1 

. 67414021 E-l 1-0. 43389004E- 16 2 

. 12519400E-03 0.22544496E-06 3 

.46274790E 01 0.00000000 4 

300.000 5000.000 13.01890 1 

. 69689940E- 10-0. 21274952E- 14 2 

•20031372E-03-0.40129814E-06 
. 17628023E 01 0.00000000 

300.000 5000.000 14.02680 

25956899E-09-0. 17110673E-13 
21724137E-02-0. 13323408E-05 
22627869E 01 0.00000000 

300.000 5000.000 30.02620 1 

47971258E-09-0.32118406E-13 2 

25701785E-02 0. 18548815E-04 
47548163E 01 0.00000000 

300.000 5000.000 46.02559 

54494809E-09-0.34704210E-13 
111 75469E-01 0.26270773E-05 
14480175E 02 0.00000000 


300.000 5000.000 


15.03470 1 


36042576E-09-0.22725300E-13 2 
38301845E-02 0. 10116802E-05 3 
24172192E 01 0.00000000 4 

300.000 5000.000 31.03410 1 
27889868E-09-0. 13731448E- 13 2 
66920184E-02 0.28148397E-05 3 
81576948E 01-0.20128906E 04 4 

300.000 5000.000 31.03410 1 
39814507E-09-0.21447125E-13 2 
71927756E-02 0.53939157E-05 3 
13137219E 02 0.00000000 4 

300.000 5000.000 16.04260 1 
39775117E-09-0. 19976425E-13 2 
25153728E-02 0. 79085839E-05 3 
45714579E 01-0. 90051691E 04 4 

300.000 5000.000 32.04200 1 
43456994E-09-0. 22136329E- 13 2 
73515214E-02 0.71443337E-05 3 
1123812 IE 02 0.00000000 4 

300.000 5000.000 26.01770 1 
16318166E- 10-0 . 36286722E- 15 2 
19239224E-02 0.47035189E-05 3 
344902 18E 01 0.00000000 4 

300.000 5000.000 40.02440 1 
16548764E-09-0. 10899129E-13 2 
72023958E-02-0. 75574589E-05 3 
602 34964 E 01 0.00000000 4 


Figure 11.1 . — Illustration of structure of standard thermodynamic data file. 



be included in this file, they should be placed here, regardless 
of the case (or cases) for which they are intended. Thus the 
same thermodynamic data (i.e., those given in the standard 
thermodynamic data file and/or the problem data file) will be 
used for all problems. 

11.2 Transport Properties Data 

Transport properties data are required only if heat transfer 
rates are to be computed by using the built-in heat transfer 
correlations (see eqs. (8.24) and (8.29)). This information 
must be supplied in a separate data file and cannot be in- 
cluded in the problem data file. A transport properties data 
file is provided with the code. This file contains coefficients 
for curve-fitted equations giving viscosity (in grams per cen- 
timeter per second xlO 6 ) and thermal conductivity (in calo- 
ries per centimeter per second per Kelvin xlO 6 ) as a function 
of temperature for 19 species (see eqs. (8.37) and (8.38)) and 
is listed in figure 1 1 .2. Each line contains data for one species 
and one transport property in the following order: species 


1U Problem Data File for Single Case 

name, the four coefficients, and the transport property. The 
format for reading each line is IX, A8, 4X, 4E15.6, 3X, A4. 
The end of the file is indicated by a line containing the word 
LAST in columns 1 to 4. 


11.3 Problem Data File for Single Case 

Following either the keyword TAPE or the end of the 
thermodynamic data the problem data file must contain infor- 
mation required to execute the first (or only) case. The vari- 
ous types of input data needed to execute a single case, in the 
order that they must be placed after the thermodynamic data 
information, are as follows: 

(1) Title line 

(2) Chemical reactions and collisional efficiencies 

(3) Inert species list 

(4) Integration and assigned variables, units, and fuel 
name line 


H2 

0.687200E 

00 

-0.617320E 

00 

-0. 111490E 

03 

0.577240E 00 

vise 

H2 

0.116129E 

01 

0.469043E 

03 

-0.551496E 

05 

-0. 14904 1 E 01 

COND 

CH30H 

0.641455E 

00 

-0.211775E 

03 

0. 125265E 

05 

0. 150983E 01 

vise 

CH30H 

0.793792E 

00 

-0.487550E 

03 

0.322097E 

05 

0.646522E 00 

C0N0 

CH4 

0.600440E 

00 

-0.817476E 

02 

0. 165196E 

04 

0.154710E 01 

vise 

CH4 

0.853201E 

00 

-0.288931E 

03 

0.193692E 

05 

0.355349E 00 

COND 

C2H2 

0.579032E 

00 

-0. 152664E 

03 

0.628889E 

04 

0. 177748E 01 

vise 

C2H2 

0.666734E 

00 

-0.330498E 

03 

0. 165066E 

05 

0. 118596E 01 

C0ND 

C2H4 

0.578808E 

00 

-0. 148526E 

03 

0.598107E 

04 

0.175623E 01 

vise 

C2H4 

0.674458E 

00 

-0.506382E 

03 

0.309615E 

05 

0. 150224E 01 

C0ND 

C3H8 

0.578645E 

00 

-0. 156438E 

03 

0.658750E 

04 

0. 156557E 01 

vise 

C3H8 

0.638223E 

00 

-0.615207E 

03 

0. 349529E 

05 

0. 183162E 01 

C0ND 

C6II6 

0.61 1472 E 

00 

-0.214866E 

03 

0. 120814E 

05 

0.144145E 01 

vise 

C6H6 

0.549565E 

00 

-0 - 765765E 

03 

0.437054E 

05 

0.222155E 01 

COND 

NO 

0.646504E 

00 

0.388567E 

01 

-0.858737E 

04 

0. 165204E 01 

vise 

NO 

0.614 175E 

00 

-0.260319E 

03 

0. 360173E 

05 

0.110633E 01 

C0N0 

N2 

0.633933E 

00 

-0. 119153E 

02 

-0. 471490E 

04 

0. 166605E 01 

vise 

N2 

0.686393E 

00 

-0. 161885E 

03 

0.236277E 

05 

0.482688E 00 

C0ND 

AR 

0. 590770E 

00 

-0.925770E 

02 

0.299040E 

04 

0.233077E 01 

vise 

AR 

0.641113E 

00 

-0.670283E 

01 

-0. 730294E 

04 

0.207105E 00 

C0ND 

0 

0.763927E 

00 

0.569723E 

02 

-0.345462E 

04 

0.822320E 00 

vise 

0 

0.776744E 

00 

0.803466E 

02 

-0. 349619E 

04 

-0.481407E-01 

C0ND 

H 

0.860209E 

00 

0.498177E 

02 

-0.542523E 

04 

-0. 102874E 01 

vise 

H 

0.869708E 

00 

0.670316E 

02 

-0.828927E 

04 

0.891354E 00 

cond 

H20 

0.756380E 

00 

-0 - 301892E 

03 

0. 187539E 

05 

0. 987951 E 00 

vise 

H20 

0 . 123241 E 

01 

-0. 163667E 

03 

0. 141541E 

05 

-0.291285E 01 

C0N0 

NH3 

0.596434E 

00 

-0.314839E 

03 

0. 271390E 

05 

0. 197019E 01 

vise 

NH3 

0.774738E 

00 

-0.627003E 

03 

0. 664059E 

05 

0.974813E 00 

COND 

N02 

0.603384E 

00 

-0.988315E 

02 

-0.969625E 

03 

0.200464E 01 

vise 

N02 

0.504502E 

00 

-0.475725E 

03 

0.415525E 

05 

0.201241E 01 

COND 

OH 

0.597497E 

00 

-0.365001E 

03 

0.351359E 

05 

0.217217E 01 

vise 

OH 

0.812287E 

00 

-0.264930E 

03 

0.343595E 

05 

0. 105187E 00 

COND 

CO 

0. 779825E 

00 

0. 193974E 

03 

-0.317845E 

05 

0.436375E 00 

vise 

CO 

0.800546E 

00 

-0.237400E 

02 

0.80454 IE 

04 

-0.468414E 00 

COND 

C02 

0.440370E 

00 

-0.288400E 

03 

0.193120E 

05 

0.324659E 01 

vise 

C02 

0.603518E 

00 

-0.438483E 

03 

0. 322949E 

05 

0. 134023E 01 

COND 

02 

0 . 659260E 

00 

0.941422E 

00 

-0.711780E 

04 

0. 164432 E 01 

vise 

02 

0.478050E 

00 

-0.452958E 

03 

0.579015E 

05 

0.228192E 01 

COND 


LAST 


Figure 1 1 .2. — Transport properties data file supplied with LSENS. 
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11. Description of Code Usage 

(5) Problem data, related options, heat transfer data, and 
output controls (namelist PROB) 

( 6 ) Assigned temperature profile (namelist TMPDAT) 
(optional) 

(7) Perfectly stirred reactor problem data (namelist 
WSPROB) (optional) 

( 8 ) Initial conditions (and namelist START) 

(9) Local error tolerances and other integration controls 
(namelist SOLVER) 

(10) Sensitivity analysis data (and namelist SENRXN) 
(optional) 

(11) FINIS line 

For each of these data types we describe the variables that 
have to be set and, where appropriate, give both the values to 
be assigned and the default values. Figure 1 1 .3 gives the flow 
diagram of the necessary input, including available options. 

11.3.1 Tide Line 

The first line after the thermodynamic data information is 
a title message, with a maximum length of 80 characters. 
This input line, which is read with the format 20A4, is pro- 
vided as a convenient means of identifying the problem. If a 
title is not needed, a blank line must be inserted here. 

11.3.2 Chemical Reactions and Collisional Efficiencies 

For all problems the user must provide the chemical reac- 
tion mechanism and the rate coefficient data. The mechanism 
may contain a maximum of 250 reactions involving as many 
as 50 species. Any collisional reaction, including the sponta- 
neous activation or deactivation of excited-state species, can 
be used. However, a maximum of only two different reactant 
and two different product species may be specified for a reac- 
tion. Therefore the following types of reactions are allowed: 


v l S l +v 2^2 “ V 3 S 3 + V 4 S 4 

( 11 . 1 ) 

VjSj ~ V 3 '2 3 + V 4 2 4 

( 11 . 2 ) 

v j2,+ v 22 2 i v 3 2 3 

(11.3) 

v 2 2 2 v 3 2 3 

(11-4) 

M + V|2, + v 2 2 2 - v 3 2 3 +M 

(11.5) 

M + v 2 2 2 - v 3 2 3 + v 4 2 4 +M 

( 11 . 6 ) 

M + v 2 2 2 - v 3 2 3 + M 

(11.7) 

h\ + v 2 2 2 -* v 3 2 3 + v 4 2 4 

( 11 . 8 ) 


In these equations v/ is the stoichiometric coefficient (i.e., 
number of moles) of reactant species i in the reaction, v/' is 
the stoichiometric coefficient of product species i in the reac- 
tion, S / is the chemical symbol of species i, the species M 
represents a general third-body collision partner, and the 
quantity hv represents a single quantum of radiation. The 
single arrow in equation ( 11 . 8 ) indicates that the photochemi- 
cal reaction is irreversible. The double arrows in the other 
reactions, equations (11.1) to (1 1.7), mean that they can be ei- 
ther reversible or irreversible. 

Following the title line the chemical reactions must be 
listed, one per line. The line has fields for the stoichiometric 
coefficients and names of two reactant and two product spe- 
cies. A general third-body species is denoted by the symbol 
M and a quantum of radiation by HNU. The symbol for the 
species electron is E in the standard thermodynamic data file 
supplied with LSENS. The reaction line also has fields for in- 
dicating a reversible or irreversible reaction and the special 
rate coefficient expression, equation (8.4). Values for the rate 
coefficient parameters Aj y nj , and either Ej or cj (see eqs. (8.3) 
and (8.4)) must be specified here. These parameters must be 
given in cgs units, that is, moles, centimeters, seconds, and 
calories. The reactions may be placed in any order, regardless 
of type. The format of each reaction line is 2(F3.1, A 8 , IX), 
Al, 2(F3.1, A 8 , IX), Al, E10.4, 2F10.4, as shown in 
table 1 1 . 1 . If a stoichiometric coefficient is not listed, that is, 
the corresponding columns are left blank, a value of unity will 
be used. 

If numerical instability or other difficulty occurs while 
processing the input data, the user should check the reaction 
mechanism, especially the three rate coefficient parameters, 
to ensure that every variable has been placed in its correct 
field. The image produced of the input data file (see chapter 
12 , section 12 . 1 , for details) will assist the user in performing 
this task. These checks should also be made if any problems, 
such as excessive computational work or questionable results 
(e.g., exceedingly long or short induction delay or heat re- 
lease time) occur. 

The reaction mechanism may contain up to 35 general 
third-body collisional reactions, that is, one with M as a reac- 
tant and/or a product species. For any such reaction colli- 
sional efficiencies different from 1.0 may be specified for as 
many as 10 species as follows: A line with the word 
THIRDBODY in columns 4 to 12 is placed immediately after 
the collisional reaction for which third-body efficiencies are 
to be considered. This line is followed by one or more lines, 
each containing names and collisional efficiencies of up to 
four species (for which the efficiencies are different from 
unity). The Aj factor for any reaction of this type is for a stan- 
dard collision partner, usually nitrogen or an inert gas such as 
argon. The format used to read each line is 4(A8, 2X, F10.3), 
corresponding to the variables in table 11 . 2 . 

The end of the third-body collisional efficiency list is indi- 
cated by either a blank line or the word END in the first three 
columns of a species field. If exactly four species are listed 
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Figure 1 1 .3. — Structure of problem data file for single (or first) case. 
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TABLE 11.1— FORMAT OF REACTION LINE 


Columns 

Variable 

type 

Format 

Content and explanation 

1-3 

Real 

F3.1 

Stoichiometric coefficient of first reactant if two reactants are present; 
default value, 1.0 

4-11 

Character 

A8 

(a) Name of first reactant if two reactants are present 

(b) Letter M in column 4 if a collisionai decomposition reaction 

(c) HNU in columns 4 to 6 if a photochemical decomposition reaction 

13-15 

Real 

F3.1 

Stoichiometric coefficient of second reactant (only reactant if a 
decomposition reaction); default value, 1.0 

16-23 

Character 

A8 

Name of second (or only) reactant 

25 

Character 

A1 

Equal to symbol (=) if reaction is reversible; any other symbol if it is 
irreversible 

26-28 

Real 

F3.1 

Stoichiometric coefficient of first product (only product if a 
recombination reaction); default value, 1 .0 

29-36 

Character 

A8 

Name of first (or only) product 

38-40 

Real 

F3.1 

Stoichiometric coefficient of second product if two products are present; 
default value, 1.0 

41-48 

Character 

A8 

(a) Name of second product if two products are present 

(b) Letter M in column 41 if a collisionai recombination reaction 

50 

Character 

A1 

Leave blank for equation (8.3); write “S” if equation (8.4) is used for k } 

51-60 

Double 

precision 

E10.4 

for equation (8.3) or (8.4) 

61-70 

Double 

precision 

F10.4 

rij for equation (8.3) or (8.4) 

71-80 

Double 

precision 

F10.4 

Ej for equation (8.3) or Cj for equation (8.4) 
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113 Problem Data File for Single Case 

TABLE 11.2.— FORMAT OF THIRD-BODY 
COLLISIONAL EFFICIENCY LINE 


Columns 

Variable 

type 

Format 

Content 

1-8 

Character 

A8 

Species name 

11-20 

Real 

F10.3 

Collisional efficiency 

21-28 

Character 

A8 

Species name 

31-40 

Real 

F10.3 

Collisional efficiency 

41-48 

Character 

A8 

Species name 

51-60 

Real 

F10.3 

Collisional efficiency 

61-68 

Character 

A8 

Species name 

71-80 

Real 

F10.3 

Collisional efficiency 


on the last line, an additional line that either contains the 
word END in columns 1 to 3 or is blank must be added. 

The end of the reaction list is denoted by either a blank 
line or the word END in columns 4 to 6. 

11.3.3 Inert Species List 

Following the reaction list, the names of any inert species, 
that is, species present but not reacting, must be given, eight 
per line, starting in columns 1, 11,21,31, 41, 51, 61, and 71. 
The format for each line is 8(A8, 2X). The end of the inert 
species list is indicated by a species field that either is blank 
or contains the word END in the first three columns. If the 
last line in this list contains exactly eight species, the next 
line should either be blank or have the word END in columns 
1 to 3, as a more positive indicator of the end of the list. If no 
inert species is to be considered for the problem, the reaction 
list must be followed by a line that either contains the word 
END in columns 1 to 3 or is blank. 

11.3.4 Integration and Assigned Variables, 

Units, and Fuel Name Line 

The line following the inert species list specifies the inde- 
pendent variable for the problem and, as described here, the 
variable, if any, for which the user intends to assign a profile. 
This line also contains the input units, the output units, and 
possibly the fuel name. 

The independent variable for the ordinary differential 
equations describing reaction chemisty depends on the prob- 
lem. This variable, which we call the integration variable, can 
be either time or distance for any flow problem, including 
that following an incident shock or a perfectly stirred reactor 
computation. For a static problem, however, only time may 
be used. 

To solve a static reaction problem, the user must provide 
either the pressure p or density p for the entire integration 
interval. Of the two, only pressure may be assigned as a func- 


tion of time — density can be prescribed only as constant. For 
a flow problem the solution for either pressure p or area A 
must be supplied. In this case either quantity may be 
described by a function of either time or distance. The vari- 
able, pressure or area, for which a nonconstant profile can be 
given is called the assigned variable. Its name, PRESSURE 
or AREA, must be included on this line, even if it is specified 
as constant. If neither of the two variables is assigned (e.g., a 
constant-density problem), the corresponding field must be 
blank. The same is true when the assigned variable is de- 
scribed by a built-in function (e.g., a flow problem following 
an incident shock computation). 

Either the same or different units may be selected for input 
and output. Table 11.3 lists the input units for each of the 
three systems, cgs, U.S. customary, and SI, built into the 
code. 

The initial composition of the reacting mixture is usually 
specified by means of mole or mass fractions. However, for a 
general hydrocarbon fuel the user has the option of specify- 
ing this information by the simple means of either the fuel- 
oxidant equivalence ratio or the fuel-oxidant mass ratio. If 
the user intends to use the simplified-composition input 
option, the name of the fuel must be entered on this data line. 
The fuel name may be given even if this option is not used. 

The integration and assigned variables, units, and fuel 
name line therefore contains only character variables, and its 
format is 4(A4, 6X), A8. The keywords and variable name 
that must be included here are given in table 1 1.4, with the 
default option, if any, underlined. If the fuel name is not 
required and default options are to be used for all other vari- 
ables, this line may be blank. 

11.3.5 Problem Data, Related Options, Heat Transfer 
Data, and Output Controls (Namelist PROB) 

Next additional information regarding the problem to be 
solved is given in a namelist called PROB. It contains the 
logical variables that designate the problem type. The choices 
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TABLE 11.3.— UNITS FOR INPUT VARIABLES IN THE 
THREE SYSTEMS ALLOWED BY CODE 


Variable 

Units a 

cgs 

(internal) 

US 

customary 

SI 

Mass 

g 

lb 

kg 

Length 

cm 

ft 

m 

Time 

s 

s 

s 

Density 

g/cm 3 

Ib/ft 3 

kg/m 3 

Pressure 15 ’ 0 

atm 

lbf/ft 2 

N/m 2 

Area c 

2 

cm 

ft 2 

m 2 

Volume 

3 

cm 

ft 3 

m 3 

Temperature 

K 

°R 

K 

Velocity 

cm/s 

ft/s 

m/s 

Mass flow rate 

g/s 

lb/s 

kg/s 

Mixture 

Mole or mass 

Mole or mass 

Mole or mass 

composition 

fraction 

fraction 

fraction 


a Activation energy must be in calories per mole, and the 
preexponential factor in cgs units. 

^Pressure may also be specified in torr (millimeters of mercury) 
for all three systems. 

c For rocket performance calculations the combustion chamber 
pressure and the nozzle throat area must be given in pounds per 
square inch absolute and square inches, respectively. 


TABLE 11.4. — DESCRIPTION OF INTEGRATION AND ASSIGNED VARIABLES, 
UNITS, AND FUEL NAME LINE 


Columns 

Content 

Explanation 

1-4 

TIME 

Time is integration (i.e., independent) variable 

1-8 

DISTANCE 

Distance is integration variable 

11-18 

PRESSURE 

Pressure profile is assigned 

11-14 

AREA 

Area profile is assigned 

(Leave blank for constant-density problem, shock 
kinetics problem, and perfectly stirred reactor 
problem with no flow problem following it) 

21-23 

CGS 

Input is in cgs (internal) units 

21-23 

FPS 

Input is in U.S. Customary units 

21-22 

SI 

Input is in SI units 

31-33 

CGS 

Output required in cgs (internal) units 

31-33 

FPS 

Output required in U.S. Customary units 

31-32 

SI 

Output required in SI units 

41-48 

Fuel name 

Name of fuel if simplified-composition input option 
will be used to specify initial mixture composition 





are static or flow kinetics, shock kinetics, perfectly stirred 
reactor (PSR) kinetics, and PSR-plus-plug-flow reaction ki- 
netics. The namelist also contains logical variables that select 
options for static and flow problems. The options related to 
problem type include constant pressure, constant density, 
constant temperature, assigned temperature, constant area, 
heat transfer, heat transfer model, equilibrium reaction, and 
sensitivity analysis. Pressure and area profiles are also speci- 
fied in PROB. Other options related to the testing of kinetic 
mechanism legality and the type of output generated are se- 
lected in this namelist. Finally, printout information is gener- 
ally given here. 

Because of the many options built into the code, PROB 
contains a large number of variables, which, together with 
their explanations, are listed in table 11.5 (default values are 
underlined). To assist the user in preparing this namelist (i.e., 
in deciding what variables have to be set), we consider each 
problem type and option in a separate subsection. The user 
has to read only the subsections relevant to the problem type 
and options selected. 

11.3.5.1 Problem types and related options. — We now 
describe how to select each problem type and the related 
options, except heat transfer, for static and flow kinetics 
problems. 

11.3.5.1.1 Static problem : For static problems the calcula- 
tion may be performed either at constant density or with a 
user-supplied pressure-versus-time profile. A constant- 
density static problem is indicated by setting the logical vari- 
able RHOCON equal to TRUE. 

An assigned-pressure static problem is selected by means 
of the keyword PRESSURE on the integration and assigned 
variables, units, and fuel name line, as described in section 
1 1.3.4. The pressure-versus-time p-t profile can be specified 
by using one of the following two methods: 

(1) In tabular form as a function of time 

(2) As a polynomial function of up to third degree 

p = CTO+ CTl *t + CT2 * f 2 +CT3 *f 3 (11.9) 

To use method (1 ), the pressure values must be set in the 
array ATB, and corresponding time values in the array TTB. 
Method (2) is selected by giving nonzero values for one or 
more of the four constants CTO, CTl, CT2, and CT3. A 
constant-pressure calculation can be performed by setting a 
nonzero value for only CTO (= the desired pressure). An al- 
ternative method of specifying a constant-pressure problem is 
to set the logical variable PCON equal to TRUE. The pres- 
sure will then be held constant at its user-supplied initial 
value (see section 11.3.8.1). The combination of the switch 
PCON equal to TRUE and a nonzero value for (only) CTO 
can also be used. 

11. 3. 5. 1.2 One-dimensional flow problem : Either pressure 
or area may be assigned for a plug-flow (i.e., no back mix- 
ing) reaction problem. An assigned-pressure flow problem is 
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selected by means of the keyword PRESSURE on the integra- 
tion and assigned variables, units, and fuel name line, as de- 
scribed in section 1 1.3.4. The pressure can be given as a func- 
tion of either time t or distance x, independently of the choice 
of integration variable. One of the following two methods can 
be used to specify p: 

( 1) In tabular form as a function of either time or distance 

(2) As a polynomial function of either time 

p = CTO + CTl * f + CT2 * t 2 +CT3*f 3 (11.10) 

or distance 

p = CXO + CXI *x + CX2 * * 2 + CX3** 3 (11.11) 

To use method (1), the pressure values must be set in the 
array ATB, and either the corresponding time values must be 
set in the array TTB or the corresponding distance values in 
the array XTB. In order to specify a p-t profile by method (2), 
nonzero values must be given for one or more of the four co- 
efficients CTO, CTl, CT2, and CT3. A p-x profile is given by 
assigning nonzero values for one or more of the four coeffi- 
cients CXO, CXI, CX2, and CX3. 

A constant-pressure calculation can be performed by set- 
ting a nonzero value for only CTO (or CXO), which must be 
set equal to the desired pressure. An alternative method of 
specifying a constant-pressure problem is to set the logical 
variable PCON equal to TRUE. The pressure will then be 
held constant at its user-supplied initial value (see section 
1 1 .3.8.1 ). The combination of the switch PCON equal to 
TRUE and a nonzero value for (only) CTO or CXO will also 
work. 

An assigned-area flow problem is selected by means of the 
keyword AREA on the integration and assigned variables, 
units, and fuel name line, as described in section 11.3.4. The 
area can be given as a function of either time t or distance x 
independently of the choice of integration variable. One of 
the following two methods can be used to specify A: 

(1) In tabular form as a function of either time or distance 

(2) As a polynomial function of either time 

A = CTO + CTl * f + CT2 * f 2 +CT3*f 3 (11.12) 

or distance 

A = CXO + CXI * jc + CX2 * Jr 2 + CX3 * j: 3 (11.13) 


To select method (1), the area values must be set in the ar- 
ray ATB, and either the corresponding time values must be set 


49 



TABLE 11.5 — DESCRIPTION OF NAMELIST PROB 


Variable 

name 

Variable 

type 

Value 

Explanation 

ACON 

Logical 

TRUE 

FALSE 

Area is assigned as constant 
Area may vary for problem 

APRINT 

Real 

— 

Array of areas or pressures at which output is desired; maximum number 
of print stations, 100 

ATB 

Real 

— 

Array of areas or pressures when specifying assigned variable in tabular 
form; maximum number of values, 100 

ATHROT 

Real 

— 

Rocket nozzle throat area in square inches 

BETA 

Real 

— 

Dimensionless boundary layer parameter; used to compute LSUBM for 
shock kinetics problem 

BORE 

Real 

— 

Diameter of piston used for computing heat transfer coefficient when 
OTTO = TRUE; default value, 9 cm 

COMBUS 

Logical 

TRUE 

FALSE 

Equilibrium computation is to be performed 
Equilibrium computation is not required 

CONC 

Logical 

TRUE 

FALSE 

Mixture composition is to be printed out as moles per unit volume 
Mixture composition is to be printed out as mass fractions 

CTO, CT1, 
CT2, CT3 

Real 


Coefficients in assigned variable AVAR versus time t equation: 
AVAR = CTO + CTl*f + CT2*/ 2 + CTC** 3 

CXO, CXI, 
CX2, CX3 

Real 


Coefficients in assigned variable AVAR versus distance x equation: 
AVAR = CXO + CXl*x + CX2** 2 + CX3*^ 

D 

Real 


Hydraulic diameter of shock tube in centimeters; used to compute LSUBM 
for shock kinetics problem 

DBUGO 

Logical 

TRUE 

FALSE 

Additional intermediate output is to be printed 
Only standard output is to be printed 

END 

Real 


Value of independent variable at which integration is to be terminated; 
integration is stopped when solution has been advanced to independent 
variable value > END 

ETA 

Real 


Dimensionless exponent in special area equation for shock kinetics problem 

EXCHR 

Logical 

TRUE 

FALSE 

Print energy exchange rate for each reaction 
Print net reaction conversion rate for each reaction 

HTRAN 

Logical 

TRUE 

FALSE 

Heat transfer between reacting system and environment is to be considered 
Heat transfer rate not required: either temperature is assigned, or 
reacting system is adiabatic 

HTO, HT1, 
HT2, HT3, 
HT4 

Real 


Coefficients in polynomial heat transfer rate Q (or Q) equation as 
function of temperature T: 

Q (or 00 = HTO + HT1T + HT2*7' 2 + HT3*7^ + HT4*! 4 

IPRINT 

Integer 

1 

Number of integration steps between output of results; default value, 5 

LSUBM 

Real 


Characteristic length in centimeters for shock tube reaction 
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Variable 

name 

Variable 

type 

ORDER 

Logical 

OTTO 

Logical 

PC 

Real 

PCON 

Logical 

PRINT 

Real 

QMREAD 

Logical 

RHOCON 

Logical 

ROCKET 

Logical 

RPM 

Real 

RXNTST 

Logical 

SENCAL 

Logical 

SENSTD 

Logical 

SHOCK 

Logical 

STROKE 

Real 

TASS 

Logical 


TABLE 11.5. — Continued. 


Value 

Explanation 

TRUE 

Ordered list of nonzero formation rates of all species due to each reaction 
is to be generated 

FALSE 

List of species formation rates by individual reactions is not required 

TRUE 

Built-in correlations arc to be used to compute internal combustion engine 
heat transfer rate for assi gned-pressure static problem 

FALSE 

Built-in correlations are not needed for heat transfer computation 


Rocket chamber pressure in pounds per square inch absolute 

TRUE 

Pressure is assigned as constant for static or flow problem 

FALSE 

Pressure may change during the reaction 


Array of integration variable values at which output is desired; maximum 
number allowed, 100 

TRUE 

Heat transfer rate is given by polynomial function of temperature 

FALSE 

Heat transfer correlations built into code are to be used for heat transfer 
rate computations 

TRUE 

Density (volume) is to be held constant for static problem 

FALSE 

Density is allowed to vary 

TRUE 

Rocket performance parameters are to be computed for flow problem 

FALSE 

Rocket performance need not be computed 

— 

Engine speed in revolutions per minute; used for heat transfer computation 
when OTTO = TRUE; default value, 1000 

TRUE 

Reaction mechanism must be checked for duplicate reactions and other 
inconsistencies 

FALSE 

Reaction mechanism legality need not be checked 

TRUE 

Sensitivity coefficient computations are required 

FALSE 

Sensitivity analysis is not needed 

TRUE 

Sensitivity coefficients of temporal derivatives of dependent variables are 
required 

FALSE 

Sensitivity coefficients of temporal derivatives of dependent variables are 
not required 

TRUE 

Incident shock kinetics computation is to be performed 

FALSE 

Incident shock computation is not needed 

— 

Length of piston used for computing heat transfer coefficient when 
OTTO = TRUE; default value, 8 cm 

TRUE 

Assigned-temperature calculation is to be performed; namelist TMPDAT 
must follow PROB (see section 11.3.6) 

FALSE 

Temperature profile will not be assigned 























11. Description of Code Usage 


TABLE 11.5.— Concluded. 


Variable 

Variable 

Value 

Explanation 

name 

type 



TCON 

Logical 

TRUE 

Temperature is to be held constant for static or flow problem 



FALSE 

Temperature may change during the reaction 

TINY 

Double 


Smallest nonzero value (in magnitude) allowed for normalized sensitivity 


precision 


coefficients; default value, 0.0 

TOTMAS 

Real 

— 

Total reacting mass for static problem with heat transfer rate given by 
polynomial equation 

TTB 

Real 


Array of times when specifying area or pressure in tabular form as 
function of time; values correspond to those in the ATB array; maximum 
number of points, 100 

TWALL 

Real 

— 

Wall temperature used with heat transfer correlation equations 

vise 

Real 

— 

Standard state dynamic viscosity in grams per centimeter per second; used 
to compute LSUBM for shock kinetics problem 

WELSTR 

Logical 

TRUE 

Perfectly stirred reactor (PSR) computation is to be performed; 
namelist WSPROB must follow PROB (see section 11.3.7) 



FALSE 

PSR computation is not required 

WSFLOW 

Logical 

TRUE 

Flow problem computation is to be performed after PSR problem, using 
PSR results for composition, temperature, density, and mass flow rate; 
namelist WSPROB must follow PROB (see section 11.3.7) 



FALSE 

Flow problem does not follow PSR problem 

XTB 

Real 


Array of distances if pressure or area is specified in tabular form as 
function of distance; values correspond to those in the ATB array; 
maximum number of points, 100 


in the array TTB or the corresponding distance values in the 
array XTB. In order to specify an A-t profile by method (2), 
nonzero values must be given for one or more of the four co- 
efficients CTO, CT1, CT2, and CT3. An A-x profile is given 
by assigning nonzero values for one or more of the four coef- 
ficients CXO, CXI, CX2, and CX3. 

A constant-area calculation can be performed by setting a 
nonzero value for only CTO (or CXO), which must be set 
equal to the desired area. An alternative method of specifying 
a constant-area problem is to set the logical variable ACON 
equal to TRUE. The area will then be held constant at its 
user-supplied initial value (see section 1 1.3. 8.1). The combi- 
nation of the switch ACON equal to TRUE and a nonzero 
value for (only) CTO or CXO is also valid. 

11.3.5.1.3 Constant-temperature problem: For either a 
static or flow problem, including that following a PSR calcu- 
lation, a constant-temperature calculation can be performed 
by setting the logical variable TCON equal to TRUE. The 
temperature will then be held constant at its user-supplied 
initial value (see section 11.3.8.1). This option cannot be used 
for the flow problem following an incident shock calculation. 


Another method of specifying a constant- temperature calcu- 
lation is described next. 

11.3.5.1.4 Assigned- temperature problem: For a static or 
flow problem, except that following either an incident shock 
or PSR calculation, the temperature profile can be given as 
described in section 1 1.3.6. To select this option, the logical 
variable TASS must be set equal to TRUE. The option can 
also be used to perform a constant-temperature calculation 
(see section 11.3.6 for details). 

11.3.5.1.5 Sensitivity analysis: This option can be selected 
for a static problem only. In order to indicate that sensitivity 
coefficients are to be computed, the logical variable 
SENCAL must be set equal to TRUE. If sensitivity coeffi- 
cients of the temporal derivatives of the dependent variables 
are also required, the logical variable SENSTD should be set 
equal to TRUE. Another variable that both controls the sensi- 
tivity computations and is set in PROB is TINY (default 
value, 0.0), which is the magnitude of the smallest normal- 
ized sensitivity coefficient that can be considered significant. 
Any normalized coefficient that is smaller in magnitude than 
TINY will be set equal to zero. 
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11.3.5.1.6 Chemical equilibrium computations : To select 
this option, the logical variable COMBUS must be set equal 
to TRUE. The code assumes that a chemical equilibrium 
computation is being performed only to obtain additional in- 
formation concerning a kinetics problem. Therefore a legal 
kinetics problem must be specified. Also, because the species 
list is constructed from the reaction mechanism, the latter 
must contain all species that are important to the equilibrium 
problem. 

Depending on the kinetics problem specified, the code will 
automatically compute the equilibrium results for one of the 
following four assigned states: temperature and pressure 
(TP), specific enthalpy and pressure (HP), temperature and 
specific volume or density (TV), and specific internal energy 
and specific volume or density (UV). An assigned volume 
calculation (TV or UV) is executed for a constant-density ki- 
netics problem (i.e., when the logical variable RHOCON is 
set equal to TRUE). For all other kinetics problem types an 
assigned-pressure calculation (TP or HP) is done. In either 
case an assigned-temperature equilibrium solution (TP or 
TV) is produced for a constant-temperature kinetics problem. 
For a nonconstant-temperature kinetics problem either an HP 
or a UV computation is executed, depending on the value of 
RHOCON. 

If the user is solely interested in the results of the chemical 
equilibrium computation, the reaction mechanism and rate 
coefficient parameters are unimportant. Hence any mecha- 
nism that contains all required species may be used, nonzero 
values specified for only the preexponential factors, and all 
reactions made irreversible to increase the efficiency of the 
kinetics computation. Indeed the reactions do not even have 
to satisfy atom and charge balance requirements. However, in 
this case, an error exit may occur during the kinetics compu- 
tation. Also reaction mechanism legality testing (see section 
11.3.5.3) must not be required. Finally, in the interest of effi- 
ciency, only one print station (see section 1 1.3. 5. 4), very 
close to the initial value of the integration variable, should be 
specified. 

11.3.5.1.7 Shock tube reaction: In order to compute the 
equilibrium and frozen conditions behind an incident shock 
wave, the logical variable SHOCK must be set equal to 
TRUE. The incident shock computations are followed by a 
one-dimensional flow problem with area assigned as a func- 
tion of distance. In particular, the area profile is given by the 
special function, equation (9.4). The exponent ETA (= r|) in 
this equation must be specified. The user must also give ei- 
ther the characteristic length LSUBM (= L m ) or the three 
quantities shock tube hydraulic diameter D (= d //), 
unshocked gas dynamic viscosity VISC (= (ij), and the 
boundary layer thickness parameter BETA (= p) so that the 
code can compute L m (see eq. (9.5)). Finally, because the 
species list is constructed from the reaction mechanism, 
the latter must contain all species important to the shock 
computations. 
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If the user is solely interested in studying postshock condi- 
tions, the reaction mechanism and rate coefficient parameters 
are unimportant. Hence any mechanism that contains all re- 
quired species may be used, nonzero values specified for 
only the preexponential factors, and all reactions made irre- 
versible to increase the efficiency of the kinetics computa- 
tion. Indeed, the reactions do not even have to satisfy atom 
and charge balance requirements. However, in this case, an 
error exit may occur during the kinetics computation. Also 
reaction mechanism legality testing (see section 11.3.5.3) 
must not be required. Finally, in the interest of efficiency, 
only one print station (see section 11.3.5.4), very close to the 
initial value of the integration variable, should be specified. 

11.3.5.1.8 Perfectly stirred reactor (PSR) problem: For 
solving a PSR problem the logical variable WELSTR should 
be set equal to TRUE. The type of problem to be solved and 
the required variables are specified elsewhere, as described in 
section 11.3.7. 

11.3.5.1.9 Combined PSR-and-plug-flow problem: A plug- 
flow calculation may be performed after a PSR problem in a 
single computer run. Such a two-step process is sometimes 
used as a simplified model of a gas turbine combustor. To 
solve this type of problem, the logical variable WSFLOW 
must be set equal to TRUE. The variables required for the 
PSR computation must be given elsewhere, as described in 
section 11.3.7. For the flow problem the assigned variable 
(pressure or area) and its profile must be specified, as de- 
scribed in section 11.3.5.1.2. 

11.3.5.1.10 Summary: The variables that must be set in 
PROB for the different problem types and options considered 
here are summarized in table 11.6. For a flow problem fol- 
lowing a PSR problem either pressure or area may be 
assigned by means of the profiles (and variables) given in 
this table. However, temperature may be assigned only as 
constant and that too only by means of the flag TCON: the 
option TASS = TRUE cannot be used. But pressure or area 
may be assigned as constant in any of the ways described in 
section 1 1.3.5. 1.2. Finally temperature cannot be assigned for 
the flow problem following a shock computation. 

11.3.5.2 Heat transfer models . — Any static or flow prob- 
lem may be nonadiabatic, with an assigned heat transfer rate. 
The logical variable HTRAN must be set equal to TRUE to 
indicate that the heat transfer rate is required. The heat trans- 
fer rate Q for a static problem or the heat transfer rate per 
unit length in the flow direction Q' for a flow problem can be 
specified by one of the following two models: 

(1) As a polynomial function of up to fourth degree in tem- 
perature T: 

Q (or Q’) = HTO+ HTI *T + HT2 * T 2 

+ HT3*7’ 3 + HT4*7' 4 (11.14) 
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TABLE 11.6 — VARIABLES THAT MUST BE SET IN NAMELIST PROB FOR 
DIFFERENT PROBLEM TYPES AND RELATED OPTIONS 3 BUILT INTO CODE 


Problem type or option 

Variables that must be set in namelist PROB 

Constant-density static 

RHOCON (= TRUE) 

Constant-pressure static 

PCON (= TRUE) and/or CTO 

Assigned-pressure static, with pressure 
specified: 

As polynomial function of time 
In tabular form as function of time 

One or more of CTO, CT1, CT2, and CT3 
ATB and TTB 

Constant-pressure flow 

PCON (= TRUE) and/or one of CTO and CXO 

Constant-area flow 

ACON (= TRUE) and/or one of CTO and CXO 

Assigned-pressure or assigned-area flow, 
with assigned variable specified: 

As polynomial function of time 
In tabular form as function of time 
As polynomial function of distance 
In tabular form as function of distance 

One or more of CTO, CT1, CT2, and CT3 
ATB and TTB 

One or more of CXO, CXI, CX2, and CX3 
ATB and XTB 

Constant-temperature static or flow b,c 

TCON (= TRUE) 

Assigned-temperature static or flow d 

TASS (= TRUE) 

Sensitivity analysis 6 

SENCAL (= TRUE); and possibly 
SENSTD (= TRUE) and TINY 

Chemical equilibrium 

COMBUS (= TRUE) 

Incident shock 

ETA; either LSUBM or all three of BETA, D, 
and VISC; and SHOCK (= TRUE) 

Perfectly stirred reactor 

WELSTR (= TRUE) 

Perfecdy stirred reactor plus plug flow 

WSFLOW (= TRUE); variables that depend on 
the assigned variable and its profile, as 
described above; and for constant temperature 
flow TCON (= TRUE) 


“Except those related to heat transfer, which are given in table 11.7. 

b An alternative method of specifying a constant-temperature problem is to set 
TASS = TRUE in PROB and the appropriate variable in namelist TMPDAT (see 
table 11.10). 

c This option cannot be used for a flow problem following an incident shock 
computation. 

d This option cannot be used for a flow problem following either an incident shock 
or a PSR computation. 

e This option can be selected for static problems only. 




(2) As built-in standard heat transfer correlations (see eqs. 

(8.22) to (8.31)) 

Only the second heat transfer model may be specified for 
the assigned-pressure, variable-volume, Otto-cycle engine 
static problem. All other static problems may use only the 
first model. For flow problems, however, either model may 
be selected. 

To select the first heat transfer model, which is the default 
option corresponding to QMREAD = TRUE (see table 1 1 .5), 
nonzero values must be given for one or more of the five co- 
efficients HTO, HT1, HT2, HT3, and HT4 in equation 
(11.14). In addition, for a static problem the total mixture 
mass TOTMAS must be supplied. 

To use the second heat transfer model, QMREAD must be 
set equal to FALSE and the transport properties data file 
made available. The wall temperature TWALL (= T w in eq. 
(8.22)) must also be specified. Finally for the Otto-cycle 
model the variable OTTO must be set equal to TRUE and 
values given for engine speed RPM (in revolutions per 
minute) and cylinder bore BORE and stroke STROKE. 

In summary, if heat transfer is to be considered, the 
required information depends on both the problem type and 
the heat transfer model. Table 1 1.7 lists the variables that 
must be specified for heat transfer computations. The default 
value for QMREAD is TRUE, so that this quantity need not 
be set if the heat transfer rate is given as a polynomial func- 
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tion of temperature. However, we recommend supplying 
QMREAD if the problem data file contains several problems, 
and we have therefore included it in table 1 1 .7. 

11.3.5.3 Reaction mechanism tests . — The logical variable 
RXNTST controls whether the legality of the reaction 
mechanism is tested. Setting RXNTST equal to TRUE tells 
the code to check that no reaction is duplicated and that each 
reaction satisfies charge and atom balance requirements. We 
strongly recommend that this option be used when either 
developing or preparing a new mechanism. 

11.3.5.4 Print stations . — The user has a choice of three 
options (in namelist PROB) for specifying when the solution 
is to be generated. The results may be printed at designated 
values of either the integration variable ^ or the assigned 
variable. The third option is to print the solution at intervals 
of a prescribed number of integration steps. For the flow 
problem behind an incident shock wave, only the first or third 
option may be used. For all other flow problems, including 
that following a PSR problem, any option may be selected. 
The same is true for any static kinetics-only or kinetics-plus- 
sensitivity problem. 

To use the first option, the output stations — the ^ values at 
which the solution is required — must be entered into the ar- 
ray PRINT. The output stations must be listed in order of in- 
creasing Any output station that is either less than or equal 
to the previous one will be ignored. The same is true of any 
output station that is not greater than the user-supplied initial 
value of 


TABLE 11.7 — VARIABLES THAT MUST BE SET IN NAMELIST 
PROB FOR HEAT TRANSFER COMPUTATIONS 


Problem type 

Heat transfer model 

Variables that must be set in 
namelist PROB 

Constant-density 

static 

Polynomial function 
of temperature 3 

HTRAN (= TRUE); one or more of 
HTO, HT1, HT2, HT3, and HT4; 
QMREAD (= TRUE) b ; and TOTMAS 

Assigned-pressure 

static 

Polynomial function 
of temperature 

HTRAN (= TRUE); one or more of 
HTO, HT1, HT2, HT3, and HT4; 
QMREAD (= TRUE) b ; and TOTMAS 


Built-in correlations 

BORE, HTRAN (= TRUE); OTTO 
(= TRUE); QMREAD (= FALSE); 1 

RPM; STROKE; and TWALL 

Assigned-pres sure 
or assigned-area 
flow 

Polynomial function 
of temperature 

HTRAN (= TRUE); one or more of 
HTO, HT1, HT2, HT3, and HT4; and 
QMREAD (= TRUE) b 


Built-in correlations 

HTRAN (= TRUE); QMREAD 
(= FALSE); and TWALL 


^This is the only heat transfer model allowed for constant-density static problems. 
^^The default value for QMREAD is TRUE. 
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11. Description of Code Usage 

The second option may be selected only if the assigned 
variable is specified in tabular form and that too only as a 
monotonic function of To use this option, the assigned- 
variable values at which output is required must be entered 
into the array APRINT. Also they must be ordered such that 
the resultant ^ values at which output is produced increase. 
That is, if the values in ATB increase monotonically, so 
should the APRINT values, and vice versa. 

To use the third option, values must be given for the inte- 
ger variable IPRINT (= the number of integration steps be- 
tween output of results) and the real variable END 
(= the ^ value at which the integration is to be terminated). 
The integration is stopped on the first step for which 
t, > END, and the results computed on this step are also 
printed. 

The above three methods are summarized in table 1 1 .8, 
which also lists the variables that must be set in PROB. A 
fourth method, described in section 11.3.6 may be used for a 
certain type of assigned-temperature problem. If this option 
will be used, data concerning output frequency must not be 
given in PROB. 

11.3,5.5 Output information specification . — As described 
in chapter 12, for each problem type certain standard infor- 
mation is generated automatically at each print station. Also 
some optional quantities can be obtained either in place of, or 
in addition to, standard output. The optional output informa- 
tion that is produced depends on the values assigned for the 
logical variables CONC, DBUGO, EXCHR, ORDER, and 
ROCKET (see table 11.5). All variables, except ROCKET, 
may be specified for any static or flow problem, including 
that following a shock computation or a PSR problem. For 
static and postshock flow problems, however, ROCKET is 


not relevant and must not be used. None of the variables, 
except DBUGO will have any impact on the information pro- 
duced for sensitivity analysis, equilibrium, shock, and PSR 
computations. 

The mixture composition is printed out as mole fractions 
and moles per unit volume. If the user prefers mass fractions 
to molar concentrations, CONC should be set equal to 
FALSE. (Mole fractions will, however, always be given.) 

Setting DBUGO equal to TRUE will result in the output of 
several intermediate quantities that are useful for debugging. 
This option may also be used with a PSR calculation for the 
same purpose. The variables that are actually printed are 
listed in chapter 12 (see table 12.2), which may be consulted 
for details. 

Another standard output quantity that can be replaced by an 
optional one is the net reaction conversion rate, equa- 
tion (8.56), which is the net reaction rate divided by the square of 
the density and is printed for each reaction. It is provided as a 
convenient means of comparing net reaction rates. In its place the 
net energy exchange rate, equation (12. 13), which is proportional 
to the heat release rate from a reaction, can be obtained by setting 
EXCHR equal to TRUE. This quantity is useful in certain situa- 
tions, such as identifying reactions that are important to an igni- 
tion or heat release process. 

A more definitive idea of the relative importance of reac- 
tions to species formation rates can be obtained by means of 
the option ORDER. If this logical variable is set equal to 
TRUE, an ordered list of nonzero net formation rates due to 
each reaction, equation (8.58), will be given for every species. 

During a nozzle expansion process the rocket performance 
parameters specific impulse, vacuum specific impulse, area 
ratio, characteristic velocity, and thrust coefficient, equations 


TABLE 1 1.8. — OPTIONS THAT SPECIFY WHEN OUTPUT IS TO 
BE GENERATED AND VARIABLES THAT MUST BE SET IN 
NAMELIST PROB FOR EACH OPTION 


When is output required? a 

Variables that 
must be set 
in namelist PROB 

At specified values of the integration variable 

PRINT 

At specified values of the assigned variable (area or pressure)* 5 

APRINT 

At intervals of a specified number of integration steps c 

IPRINT and END 


a See section 11.3.6 for a fourth method of specifying print stations. 
b In this case the assigned variable must be specified in tabular form, and that too 
only as a monotonic function of the integration variable. Also, values must be 
entered into APRINT in the same order (i.e., increasing or decreasing values) as in 
ATB. 

c In this case output is also produced after the problem is completed (i.e., at the 
value (> END) of the independent variable reached on the final integration step). 
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(12.14) to (12.18), can be computed by setting ROCKET 
equal to TRUE. If this option is selected, the nozzle throat 
area ATHROT (in square inches) and the rocket combustion 
chamber pressure PC (in pounds per square inch absolute) 
must be supplied. 

In order to follow the kinetic process in the flow through a 
converging-diverging nozzle with the present version of 
LSENS, the following three steps should be taken: 

(1) Initial conditions for the subsonic flow problem in the 
converging portion of the nozzle (i.e., upstream of the throat) 
should be obtained by performing equilibrium calculations 
with a code such as CET (ref. 11). 

(2) The kinetically limited pressure profile in this region of 
the nozzle is assumed to be the same as the equilibrium pres- 
sure profile, which is therefore assigned for the flow calcula- 
tion. Starting with equilbrium conditions at some convenient 
point, the computation should be carried through the throat 
until the Mach number just exceeds 1.05. 

(3) Finally the resulting conditions from step (2) provide 
<he initial state for the flow problem in the diverging section, 
vhose area profile must be assigned. 


113 Problem Data File for Single Case 

For high chamber pressures (e.g., > 60 psia (414 kPa)) this 
procedure can be speeded up by eliminating step (2); that is, 
by assuming equilibrium flow up to a point just downstream 
of the throat (e.g., where the Mach number just exceeds 

I. 05). The equilibrium results at this point provide the neces- 
sary initial conditions for the supersonic assigned-area kinetic 
computation in the diverging section. The validity of this pro- 
cedure is quite good, except for very low chamber pressures. 
For a given chamber pressure the nozzle position where the 
results of the kinetically limited and equilibrium computa- 
tions begin to differ significantly from one another can only 
be determined by comparing the two. 

II. 3.6 Assigned-Temperature Profile 

(Namelist TMPDAT) 

For an assigned-temperature problem (i.e., TASS = TRUE 
in PROB) the required data should be set in a namelist called 
TMPDAT, which must follow PROB. In addition to the tem- 
perature profile the namelist contains an option for specifying 
when output is to be generated. Table 1 1 .9 gives the complete 
list, and description, of the variables in TMPDAT. 


TABLE 11.9.— DESCRIPTION OF NAMELIST TMPDAT 


Variable 

name 

Variable 

type 

Explanation 

CTO, CT1, 
CT2, CT3 

Real 

Coefficients in polynomial equation for 
temperature T as function of time t: 

T = CT0 + CT1*/ + CT2*/ 2 + CT3** 3 

CXO, CXI, 
CX2, CX3 

Real 

Coefficients in polynomial equation for 
temperature T as function of distance x: 

T = CXO + CXI *x + CX2*x 2 + CX3*x 3 

TMPTB 

Real 

Array of temperatures when assigning temperature 
in tabular form as function of time or distance; 
maximum number of values, 100 

TPRINT 

Real 

Array of temperatures at which printout is 
desired; maximum number of print stations, 100 a 

TTB 

Real 

Array of times when specifying temperature 
table as function of time; values correspond 
to those in TMPTB; maximum number of 
points, 100 

XTB 

Real 

Array of distances when specifying temperature 
table as function of distance; values correspond 
to those in TMPTB; maximum number of 
points, 100 


a In this case the temperature must be specified in tabular form, and that too 
only as a monotonic function of the integration variable. Also, values must 
be entered into TPRINT in the same order (i.e., increasing or decreasing 
values) as in TMPTB. 
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11. Description of Code Usage 

For di flow problem the temperature can be given as a func- 
tion of either time or distance independently of the choices of 
the integration variable and the independent variable for the 
assigned variable. One of the following two methods can be 
used to specify the temperature T: 

(1) In tabular form as a function of either time or distance 

(2) As a polynomial function of either time t 

T = CTO + CT1 * t + CT2 * t 2 +CT3 *f 3 (11.15) 

or distance x 

T = CXO + CXI * jc + CX2 * jc 2 + CX3*jc 3 (11.16) 

To select method (1), the temperature values must be set in 
the array TMPTB, and either the corresponding time values 
must be set in the array TTB or the corresponding distance 
values in the array XTB. In order to specify a T-t profile by 
method (2), nonzero values must be given for one or more of 
the four coefficients CTO, CT1, CT2, and CT3. A T-x profile 
is given by assigning nonzero values for one or more of the 
four coefficients CXO, CXI, CX2, and CX3. 

For a static problem either of the two methods may be 
used, but temperature must be specified as a function of time. 
The procedure for selecting the T-t profile is exactly the same 
as that described for a flow problem. 

A constant-temperature calculation can be performed by 
setting a nonzero value for only (1) CTO for a static problem 
and (2) CTO or CXO for a flow problem. The appropriate 
variable must be set equal to the desired temperature. 

The user can require printout of the solution at specified 
values of the temperature, but only if it is assigned in tabular 
form and that too only as a monotonic function of the integra- 
tion variable. To use this option, the temperature values at 
which output is required must be entered into the array 
TPRINT. Also they must be ordered such that the resultant ^ 


values at which output is produced increase. That is, if the 
values in TMPTB increase monotonically, so should the 
TPRINT values, and vice versa. Finally no print station 
information must have been given in PROB (see section 
11.3.5.4 and table 11.8). 

The variables that must be set in TMPDAT depend on 
whether temperature is a function of time or distance and on 
the form of the temperature profile. Table 11.10 summarizes 
the information required for each of the options built into the 
code. 

11.3.7 Perfectly Stirred Reactor Problem Data 
(Namelist WSPROB) 

For a PSR problem (i.e., WELSTR = TRUE and/or 
WSFLOW = TRUE in PROB) the required data are given in 
a namelist called WSPROB, which must follow PROB. The 
type of PSR computation — assigned mass flow rate or as- 
signed temperature — is specified here. In either case a 
sequence of PSR solutions is generated until the desired 
condition is reached. The required data for each problem type 
and heat transfer and output control information are given 
in this namelist. Table 11.11 gives the complete list of vari- 
ables in WSPROB and their descriptions, with default values 
underlined. 

To select an assigned-mass- flow -rate problem , the variable 
DELMD must be set equal to the desired mass flow rate in- 
crement between successive solutions. Also DOTMAX, the 
desired mass flow rate through the reactor, must be given. 

To select an assigned-temperature problem , the variable 
DELT, the temperature decrement between successive solu- 
tions, must be set. (The first solution is attempted with a tem- 
perature of TEQ - DELT, where TEQ is the equilibrium 
temperature for the reactor inlet state.) The user must also 
assign a value for either DTMAX, the maximum temperature 
decrement, or TMPMIN, the desired temperature at the reac- 


TABLE 11.10 — VARIABLES THAT MUST BE SET IN NAMELIST TMPDAT 
FOR ASSIGNED-TEMPERATURE PROBLEM 


Temperature 

profile 

Temperature 
profile type 

Variables that must be set in 
namelist TMPDAT 

Temperature 
versus time 

Constant 3 

Polynomial 

Tabular 

CTO 

One or more of CTO, CT1, CT2, and CT3 
TMPTB and TTB 

Temperature 
versus distance 

Constant 3 

Polynomial 

Tabular 

CXO 

One or more of CXO, CXI, CX2, and CX3 
TMPTB and XTB 


a See table 11.6 for an alternative method of specifying a constant-temperature 
problem. 
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113 Problem Data File for Single Case 


TABLE 11.11.— DESCRIPTION OF NAMELIST WSPROB 


Variable 

name 

Variable 

type 

Value 

Explanation 

DELMD 

Real 


Mass flow rate increment for assigned-mass-flow-rate 
problem 

DELT 

Real 

— 

Temperature decrement (absolute value) for assigned- 
temperature problem 

DOTMAX 

Real 


Desired mass flow rate for assigned-mass-flow-rate 
problem 

DTMAX 

Real 


Maximum temperature decrement desired for assigned- 
temperature problem; temperature at reactor exit will be 
set equal to (TEQ - DTMAX), where TEQ is the 
equilibrium temperature for the inlet state 

MPR 

Integer 


Control variable for printout: printout occurs after first 
and, thereafter, every MPRth convergence; default 
value, 1 

RITE 

Logical 

TRUE 

FALSE 

Extra debug output will be printed on every iteration 
Only standard output will be printed 

TMPMIN 

Real 


Desired temperature at reactor exit for as signed- 
temperature problem 

VOLUME 

Real 


Volume of reactor 

WSRHTR 

Logical 

1 

TRUE 

FALSE 

Reactor is not adiabatic and heat transfer rate is given 
by polynomial function of temperature (see below) 
Reactor is adiabatic 

WSRHTO, 

WSRHT1, 

WSRHT2, 

WSRHT3, 

WSRHT4 

Real 


Coefficients in heat transfer rate Q versus temperature T 
expression: 

Q = WSRHTO + WSRHT1*7' + WSRHT2*7' 2 + 
WSRHT3*7 3 + WSRHT4*! 4 


tor exit. If DTMAX is given, the reactor exit temperature will 
be set equal to TEQ — DTMAX. If both DTMAX and 
TMPMIN are specified, the value min(TMPMIN, TEQ — 
DTMAX) will be assigned for the exit temperature. 

For both problem types the variable VOLUME must give 
the reactor volume. If the problem is not adiabatic and heat 
transfer must be considered, the logical variable WSRHTR 
should be set equal to TRUE. Also nonzero values must be 
supplied for one or more of the five coefficients in the fol- 
lowing equation for the heat transfer rate Q as a polynomial 
function of temperature T: 

Q = WSRHT0+ WSRHT1 *T + WSRHT2 * T 2 

+ WSRHT3 * r 3 + WSRHT4 * T 4 (11.17) 


Finally WSPROB contains the variables MPR and RITE, 
which control, respectively, the frequency and detail of out- 
put generated during the PSR calculation. Results of the con- 
verged solution are printed after the first and thereafter after 
every MPRth convergence. If the logical variable RITE is set 
equal to TRUE, reaction rate information is printed after ev- 
ery iteration. This information may be useful for debugging 
and is described in chapter 12 (see section 12.5.2 and 
table 12.2). Additional intermediate information may be 
obtained by setting DBUGO equal to TRUE in PROB (see 
section 1 1.3. 5. 5). 

The problem type (i.e., assigned mass flow rate or assigned 
temperature) dictates what variables must be set in 
WSPROB. The data required for both problem types are 
summarized in table 11.12. The code identifies the problem 
by examining DELMD and DELT; therefore nonzero values 
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11. Description of Code Usage 


TABLE 11.12.— VARIABLES THAT MUST BE SET IN 
NAMELIST WSPROB FOR PERFECTLY STIRRED 
REACTOR PROBLEM 3 


Problem type 

Variables that must be set in 
namelist WSPROB b 

Assigned mass 
flow rate 

DELMD; DOTMAX; MPR; VOLUME; and 
for problem with heat transfer WSRHTR 
(= TRUE) and one or more of WSRHTO, 
WSRHT1, WSRHT2, WSRHT3, and WSRHT4 

Assigned 

temperature 

DELT; DTMAX and/or TMPMIN; MPR; 
VOLUME; and for problem with heat transfer 
WSRHTR (= TRUE) and one or more of 
WSRHTO, WSRHT1, WSRHT2, WSRHT3, and 
WSRHT4 


a Detailed output will be produced at every iteration if the logical 
variable DBUGO is set equal to TRUE in namelist PROB (see 
section 11.3.5.5). 

b Reaction rate information will be printed at every iteration if the 
logical variable RITE is set eqi 4 to TRUE. 


should not be given for both variables: to do so will result in 
an error exit. 

In the event of convergence to a false solution, the code 
increases the mass flow rate as part of the restart process. The 
user may therefore have to increase the original value of 
DOTMAX significantly to obtain a realistic solution under 
some conditions. For the same reason the reactor volume and 
the initial mass flow rate (see section 1 1.3.8) may also have 
to be adjusted. 

11.3.8 Initial Conditions (and Namelist START) 

For all problems the initial (or reactor inlet) state of the 
mixture must be provided. Unless already assigned in PROB 
and/or TMPDAT the required thermodynamic and fluid dy- 
namic variables must be initialized in a namelist called 
START, which will follow PROB, TMPDAT, or WSPROB, 
depending on the problem type. Time and distance may also 
be initialized in START. Finally, if the simplified- 
composition input option is used, the necessary variables are 
set here; otherwise, the mixture composition must follow 
START. In the latter case the composition may be input as 
either mole or mass fractions. The logical variable MOLEF 
in START tells the code which composition units are used, as 
explained in table 11.13 (standard options are underlined). 

The simplified-composition input option is selected by giv- 
ing either the fuel-oxidant equivalence ratio ERATIO or the 
fuel-oxidant mass ratio FLAIR. If nonzero values are speci- 
fied for both ERATIO and FLAIR, only the former will be 
used and the latter ignored. To use the first method, the stoi- 


chiometric coefficients of carbon (SCC), hydrogen (SCH), 
and oxygen (SCOX) in the fuel must be given. All three vari- 
ables are initialized to zero, and so the user has to set only the 
nonzero coefficients. If the oxidant composition is different 
from that built into the code (see table 8.1), the user must 
also supply ARAT, CRAT, and NOXRAT, which are the mo- 
lar ratios of argon, carbon dioxide, and nitrogen to oxygen, 
respectively. (For example, if the oxidant is pure oxygen, 
ARAT = CRAT = NOXRAT = 0.0.) The second method re- 
quires a value for only FLAIR, unless the oxidant composi- 
tion is different from the standard one, in which case the oxi- 
dant ratios ARAT, CRAT, and NOXRAT must also be given, 
as well as the oxidant molar mass AIRMW. (For 
example, if the oxidant is pure oxygen, AIRMW = 31.994.) 

Irrespective of the method used, MOLEF must not be set 
equal to FALSE, and the integration and assigned variables, 
units, and fuel name line must contain the fuel name (see sec- 
tion 1 1.3.4). For each of the two methods the variables that 
must be set in START are summarized in table 11.14. 

For any kinetics problem , including that following an inci- 
dent shock or PSR computation, time and distance may be 
initialized by entering the desired values into TIME and X, 
respectively. Both variables are initialized to zero before 
START is read, and so the user needs to specify only the non- 
zero ones. 

Other quantities that have to be initialized in START 
depend on the problem type and options selected. For conve- 
nience, we consider each problem type in a separate subsec- 
tion and provide a table summarizing the required input 
information in START. 
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TABLE 11.13 — DESCRIPTION OF NAMELIST START 


Variable 

name 

Variable 

type 

Value 

Explanation 

AIRMW 

Real 

— 

Molar mass of oxidant; default value, 28.9644 

AREA 

Double 

precision 


Initial area 

ARAT 

Real 


Ar/0 2 mole ratio in oxidant; default value, 0.044487 

CRAT 

Real 

— 

COj/Oj mole ratio in oxidant; default value, 0.001432 

ERATIO 

Real 


Fuel-oxidant equivalence ratio 

FLAIR 

Real 


Fuel-oxidant mass ratio 

MACH 

Real 


Initial Mach number or Mach number of gas flowing into 
incident shock 

MDOT 

Double 

precision 


Mass flow rate for flow problem. For PSR problem mass flow 
rate either assigned for first solution or to start iteration for 
as signed- temperature calculation 

MMHG 

Logical 

TRUE 

FALSE 

Pressure P (see below) is given in torr (millimeters of mercury) 
Pressure P is given in user’s chosen input units 

MOLEF 

Logical 

TRUE 

FALSE 

Initial (or reactor inlet) mixture composition will be given in 
mole fractions 

Initial (or reactor inlet) mixture composition will be given in 
mass fractions 

NOXRAT 

Real 


N 2 /0 2 mole ratio in oxidant; default value, 3.72735 

P 

Double 

precision 


Initial pressure or unshocked gas pressure or reactor pressure 

RHO 

Double 

precision 


Initial density or unshocked gas density or reactor inlet density 

see 

Real 


Stoichiometric coefficient of carbon in fuel; default value, 0.0 

SCH 

Real 


Stoichiometric coefficient of hydrogen in fuel; default value, 0.0 

SCOX 

Real 


Stoichiometric coefficient of oxygen in fuel; default value, 0.0 

T 

Double 

precision 


Initial temperature or unshocked gas temperature or reactor inlet 
temperature 

TIME 

Double 

precision 


Initial time 

V 

Double 

precision 


Initial velocity or shock velocity 

X 

Double 

precision 


Initial distance 
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11. Description of Code Usage 


TABLE 11.14. — VARIABLES THAT MUST BE SET IN 
NAMELIST START IF SIMPLIFIED-COMPOSITION INPUT 
OPTION IS USED TO SPECIFY INITIAL MIXTURE 
COMPOSITION 4 


Quantity used to specify 
initial mixture 
composition 

Variables that must be set in 
namelist START** 

Fuel-oxidant 
equivalence ratio 

ERATIO; SCC; SCH; SCOX; and 
if oxidant composition is different 
from the standard one, ARAT, 
CRAT, and NOXRAT 

Fuel-oxidant 
mass ratio 

FLAIR; and if oxidant composition 
is different from the standard one, 
AIRMW, ARAT, CRAT, and 
NOXRAT 


a The fuel name must be given on the integration and assigned 
variables, units, and fuel name line (see section 11.3.4). 
^OLEF must not be set equal to FALSE in START. 


11,3.8.1 Static and flow kinetics problems. — We first con- 
sider the temperature, which is initialized in START if, and 
only if, it has not been assigned in TMPDAT (see sections 
1 1 .3.5.1 .4 and 1 1 .3.6). In this case (i.e., TASS = FALSE), the 
initial (or constant) temperature must be entered into the vari- 
able T. Note that T must be specified even for a constant- 
temperature calculation selected by means of the flag TCON 
if a temperature value is not given in TMPDAT However, if 
a temperature profile, constant or otherwise, has been pre- 
scribed in TMPDAT, T must not be set: to do so will cause an 
error exit. A simple rule that summarizes these instructions is 
that namelist TMPDAT and the variable T in START cannot 
both appear in the problem data file for any problem, irre- 
spective of the value of TCON. 

The remaining variables whose initial values must also be 
set in START are as follows: For a constant-density static 
problem either pressure P or density RHO must be given. 

For an assigned-pressure static problem no additional vari- 
able needs to be set if the pressure profile has been furnished 
in PROB. However, if the flag PCON had been used in 
PROB to denote constant pressure, but its value is not given 
there, either pressure P or density RHO must be set. 

For an assigned-pressure flow problem with a pressure 
profile supplied in PROB two of the following three vari- 
ables must be given: (1) mass flow rate MDOT; (2) area 
AREA; and (3) either velocity V or Mach number MACH. If 
the flag PCON had been used in PROB to denote constant 
pressure but its value is not given there, either pressure P or 
density RHO must also be set. An alternative that will work 
in this case is to set all three variables: (1) MDOT; (2) 
AREA; and (3) either V or MACH. 


For an assigned-area flow problem with area profile pro- 
vided in PROB, the user must set two of the following three 
variables: (1) either pressure P or density RHO; (2) mass 
flow rate MDOT; and (3) either velocity V or Mach number 
MACH. If the flag ACON had been used in PROB to denote 
constant area but its value is not given there, AREA must 
also be set. Alternatively values may be assigned for the three 
variables: ( 1 ) either P or RHO; (2) MDOT; and (3) either V 
or MACH. 

11.3.8.2 Incident shock problem. — For this problem type 
values must be given for the following variables: unshocked 
gas temperature T and either unshocked gas pressure P or 
unshocked gas density RHO. Also either the variable V must 
be set equal to the shock velocity or a value assigned for 
MACH, the ratio of the shock velocity to the sonic velocity 
in the unshocked gas (i.e., the quantity <JA\ in eq. (9.5)). 

11.3.8.3 PSR problem. — For both problem types the reac- 
tor inlet temperature T and either reactor pressure P or reac- 
tor inlet density RHO must be supplied. The user must also 
set MDOT, which is the mass flow rate either for the first 
solution of an assigned-mass-flow-rate problem or to start the 
iteration for the first solution of an assigned-temperature 
problem. 

11.3.8.4 PSR-plus-plug-flow problem. — For the PSR cal- 
culation the user must set T equal to the reactor inlet tem- 
perature and MDOT equal to the mass flow rate that is either 
the first solution of an assigned-mass-flow-rate problem or 
the initial guess for the first solution of an assigned- 
temperature problem. 

The flow problem following the PSR calculation dictates 
what other variables must be set in START For an assigned- 
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pressure flow problem the user must supply a value for one of 
the following three variables: (1) initial area AREA; (2) ini- 
tial velocity V; and (3) initial Mach number MACH. In addi- 
tion, if a pressure profile has not been prescribed in PROB, 
either reactor pressure P or reactor inlet density RHO must be 
set. This situation arises when a constant-pressure flow prob- 
lem is selected through the flag PCON but a pressure value is 
not given in PROB. 

For an assigned-area flow problem either reactor pressure 
P or reactor inlet density RHO must be specified. In addition, 
if a constant-area flow problem has been specified through 
the flag ACON but an area value is not given in PROB, the 
user must set one of the three variables: (1) initial area 
AREA; (2) initial velocity V; and (3) initial Mach number 
MACH. 

11.3.8.5 Summary . — The thermodynamic and fluid 
dynamic variables that must be initialized in START depend 
on the problem type, related options, and information given 
in PROB and TMPDAT. For each problem type and related 
option we list these variables in table 11.15. Finally, if the 
pressure is required, P may be given in either the input units 
selected by the user or torr (millimeters of mercury). In the 
latter case the logical variable MMHG must be set equal to 
TRUE in START. 

11.3.8.6 Initial mixture composition . — Immediately fol- 
lowing START, the initial (or reactor inlet) mixture composi- 
tion is specified by listing the species names and their initial 
(or reactor inlet) mole or mass fractions, depending on the 
value assigned to MOLEF. The default composition, corre- 
sponding to MOLEF = TRUE, is mole fraction. For each spe- 
cies the data are given on a new line, which is read by using 
the format A8, 2X, FI 5. 13. The species name is written, start- 
ing in column 1, exactly as in the chemical reactions. The 
species mole or mass fraction is written in columns 1 1 to 25, 
in either fixed- or floating-point format. All mole and mass 
fractions are initialized to zero, and so only species with non- 
zero initial concentration need to be included in the composi- 
tion list. The end of this list is signaled by a line that either is 
blank or contains the word END in columns 1 to 3. 

Even if the simplified-composition input option is used, 
the list of species names and mole fractions may be given. 
This feature enables the user to include some trace species in 
the initial mixture. However, the sums of the mole and mass 
fractions of all species must not exceed unity by more than 
10 -4 and 5x10 , respectively. Finally, if the initial mixture 

consists of only the fuel and standard oxidant species (i.e., 
oxygen, nitrogen, argon, and carbon dioxide, see table 8.1), 
the line following START must either be blank or contain the 
word END in columns 1 to 3. 

11.3.9 Local Error Tolerances and Other Integration 
Controls (Namelist SOLVER) 

All controls for the LSODE package (refs. 20 to 22), 
which is used to solve the governing ordinary differential 
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equations, are read in from a namelist called SOLVER, which 
must follow the initial composition list. For a perfectly 
stirred reactor problem without a flow problem following it, 
this namelist is not required, but its inclusion will not cause 
an error exit. SOLVER contains variables that select the 
integration and corrector iteration methods. Local error toler- 
ances and other control variables are also set here. The com- 
plete list of variables in SOLVER, with brief explanations, is 
given in table 11.16. 

The only two parameters that the user will usually set in 
SOLVER are EMAX, the local relative error tolerance for all 
variables, and ATOSLP, the local absolute error tolerance for 
reacting species mole numbers. The two tolerances control 
both the speed and accuracy of the integration and must 
therefore be chosen carefully; see, for example, reference 38, 
which examines the accuracy of several solvers, including 
LSODE. The default values for EMAX and ATOLSP favor 
accuracy over computational efficiency. 

Pure relative error control is obtained by setting ATOLSP 
= 0.0; EMAX is then a measure of the number of accurate 
significant figures in the numerical solution. Setting 
EMAX = 0.0 gives pure absolute error control; ATOLSP is 
then a measure of the largest number that may be neglected. 
Now for a typical chemical reaction problem the solution 
components vary widely in magnitude, so that relative error 
control is appropriate. However, it is undefined when one or 
more solution components vanish and therefore cannot be 
used. (For example, in a typical chemical kinetics problem 
several of the species have zero initial concentration.) Hence 
mixed relative/absolute error control is used in LSENS, and 
nonzero values must generally be specified for both EMAX 
and ATOLSP. However, for a given EMAX we recommend 
using an ATOLSP that produces mostly relative error control 
for mole numbers greater than a minimum value, a m j n , that is 
not considered significant. Such error control can be obtained 
by setting ATOLSP < a m i n EMAX. The default ratio (= 1CT 9 ) 
for ATOLSP/EMAX provides this error control for mole 
fractions greater than approximately 0. 1 ppm (for a mixture 
with molar mass of order 0(100)). 

In addition to the ATOLSP/EMAX ratio the actual values 
for the two variables must be selected with care. Now 
LSODE controls only an estimate of the local error — the 
error committed on a single step, starting with data regarded 
as exact — whereas the quantity that is generally of interest to 
the user is the global error, or the deviation of the numerical 
solution from the exact solution. The global error is neither 
measured nor controlled by the code. Therefore the user is 
advised to be conservative in selecting EMAX and ATOLSP. 
However, the computational work generally increases when 
more accuracy is requested. Some experimentation may be 
necessary to optimize the tolerance parameters, that is, to find 
values that produce sufficiently accurate solutions while 
minimizing execution time. The global errors in solutions 
generated with particular values for the local error tolerances 
may be estimated by comparing them with results produced 
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TABLE 11.15. — SUMMARY OF THERMODYNAMIC AND FLUID DYNAMIC VARIABLES 
WHOSE INITIAL VALUES MUST BE SET IN NAMELIST START 


Problem type 

Assigned variable 
specified in 
namelist PROB? 

Variables whose initial values must be set in namelist 
START 

Constant-density static 

No a 

TIME b ; P or RHO; and T 

Constant-pressure static 

No d 

TIME 6 ; P or RHO; and T 


Yes 

TIME b and T° 

Assigned-pressure static 

Yes 

TIME b and T 

Constant-pressure flow 

No d ’ e 

TIME b ; X b ; P or RHO; two of MDOT, AREA, V (or 
MACH); and T” 


Yes 

TIME b ; X b ; two of MDOT, AREA, V (or MACH); 
and T 0 

Assigned-pressure flow 

Yes 

TIME b ; X b , two of MDOT, AREA, V (or MACH); 
and V 2 

Constant-area flow 

No f 

TIME b ; X b ; AREA; two of P (or RHO), MDOT, V 
(or MACH); and T” 


Yes 

TIME b ; X b ; two of P (or RHO), MDOT, V (or 
MACH); and T 0 

Assigned-area flow 

Yes 

TIME 6 ; X b ; two of P (or RHO), MDOT, V (or 
MACH); and T“ 

Incident shock 8 

Yes (see section 
11.3.5.1.7) 

TIME* 5 ; X b ; P (or RHO); V (or MACH); and T 

Perfectly stirred reactoi^ 

None required 

P (or RHO); MDOT; and T 

Perfectly stirred reactor 
plus plug flow h 

See section 
11.3.5.1.9 

TIME b ; X b ; P (or RHO)'; MDOT; T; and AREA j 


“Density cannot be assigned in PROB. 

‘initial values for time and distance need to be given only if they ate different from zero. 

®Not needed if temperature is assigned in namelist TMPDAT (see section 11.3.6). 

“This combination can be obtained only by setting PCON = TRUE in PROB. 

* Alternatively, initial values may be set for TIME”; X b ; MDOT; AREA; V (or MACH); and T\ 

This combination can be obtained only by setting ACON = TRUE in PROB. In this case initial values 
may be assigned for the following variables instead of those given above: TIME b - X b - P (or RHO)- 
MDOT; V (or MACH); and T”. 

e Initial values are for preshock state. 

hThe thermodynamic properties are for the inlet state. 

‘Required if area is the assigned variable or a constant-pressure flow problem is specified by means of the 
PCON switch and pressure is not supplied in PROB. 

J Required if pressure is the assigned variable or a constant-area flow problem is specified through the 
option ACON and area is not set in PROB. In either case the initial value of V (or MACH) may be 
supplied instead of AREA. 
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TABLE 11.16.— DESCRIPTION OF NAMELIST SOLVER 


Variable 

name 

Variable 

type 

Explanation 

ATOLSP 

Real 

Local absolute error tolerance for reacting 
species; default value, 10~ 14 

EMAX 

Real 

Local relative error tolerance for all 
variables; default value, 10~ 5 

HINIT 

Real 

Step size to be attempted on the first step; 
computed by LSODE, unless specified here 

HMAX 

Real 

Maximum step size allowed for problem; 
default value, «> 

HMIN 

Real 

Minimum step size allowed for problem; 
default value, 0 

MAXORD 

Integer 

Maximum method order to be used by 
integrator; default value, 5, for MF = 21 

MAXSTP 

Integer 

Maximum number of steps allowed for 
problem; default value, 2000 

MF 

Integer 

Method flag; default value, 21, for “stiff’ 
integrator 

MXHNIL 

Integer 

Maximum number of messages printed per 
problem warning that step size is getting too 
small; default value, 10 

MXSTEP 

Integer 

Maximum number of (internally defined) 
steps allowed during one call to LSODE; 
default value, 500 


with smaller tolerances. In reducing the tolerances both 
EMAX and ATOLSP must be scaled down uniformly. 

Another variable that can considerably influence both the 
accuracy and efficiency of the integrator is the method flag 
MF, which selects both the integration and corrector iteration 
methods (see eq. (9.1)). The default value, MF = 21, corre- 
sponds to the “stiff* integrator and the Newton-Raphson it- 
eration technique using an analytical Jacobian matrix. For 
normal code usage we cannot recommend the use of any 
other MF. The method flag MF = 22 may, however, be used 
to check the accuracy of the MF = 21 results and, in particu- 
lar, of the analytical Jacobian matrix (ref. 22). Users wishing 
to study the effects of other MF values on solution accuracy 
and efficiency are urged to consult appendix C, where any re- 
quired coding changes are described. Note, in particular, that 
if the choice MF = 14 or MF = 24 is made without modifying 
the code, numerical instability may result. Finally, if the sen- 
sitivity analysis option is selected, only MF = 21 is al- 
lowed — any other MF will cause an error exit. 


Two other variables that the user may either have or wish 
to adjust are MAXSTP, the maximum number of integration 
steps allowed for the problem, and MXSTEP, the maximum 
number of integration steps allowed during one call to 
LSODE. Exceeding MAXSTP steps without successfully 
completing the problem is a fatal error, and the execution will 
be terminated. Exceeding MXSTEP steps during one call to 
LSODE is, however, not fatal: an error message will be 
printed and the execution continued normally. 

Either of the two problems might be the result of an 
inapproprate MF. The use of MF = 10 or MF = 20 is one 
example. These difficulties may also be caused by very strin- 
gent accuracy requirements or a very long integration interval 
during which the system does not equilibrate. The user 
should also check the problem data file, especially the reac- 
tion mechanism, for errors, as described in section 1 1 .3.2. 

Either difficulty may also be caused if pure relative error 
control (i.c., ATOLSP = 0.0) has been selected but most, or 
all, of the solution components are very small but nonzero. 
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Finally, to track accurately very rapid reactions, such as dur- 
ing heat release, the integrator may be forced to select such 
small step sizes that these difficulties occur. If the step size 
becomes too small for the computer, an error message stating 
this fact is printed. The warning message is printed a maxi- 
mum number of MXHNIL (default value, 10) times per prob- 
lem. The user may change this maximum number by setting 
the integer variable MXHNIL equal to the desired value. 

The remaining variables, HINIT, HMAX, HMIN, and 
MAXORD, allow the user to change several integration con- 
trols, which are usually set by LSODE. They are placed in 
SOLVER solely for the convenience of users who are famil- 
iar with LSODE, especially reference 22. 

If default values are to be specified for all variables, a 
dummy line simply indicating the beginning and ending of 
the namelist may be used. 

11.3.10 Sensitivity Analysis Data (and 
Namelist SENRXN) 

If sensitivity analysis is required, the information that tells 
the code what sensitivity coefficients are to be computed is 
placed after namelist SOLVER. The information is of three 
types: 

(1 ) Names of dependent variables whose sensitivities are 
desired 

(2) Names of variables with respect to whose initial values 
sensitivity coefficients are required 

(3) List of reaction numbers with respect to whose rate 
coefficient parameters sensitivity coefficients are needed 
and logical variables identifying the parameters. 

Type (1) data must always be supplied, but either one or both 
of data types (2) and (3) may be given. The data types may 
be given in any order. Each data type is preceded by a key- 
word line that identifies it. 

Type (1) information (i.e., the list of dependent variables) 
is identified by a line containing the keyword SENSVAR in 
columns 1 to 7. The variable names are then listed in the next 
one or more lines, with each line containing up to a maxi- 
mum of eight names. The format used to read each line is 
8(A8, 2X); therefore the variable names must start in col- 
umns I, 11,21,31,41,51,61, and 71 . In order to request 
sensitivity coefficients for any reacting species mole number, 
its name must be given. The species name must be written 
exactly as in the chemical reactions. The name ALLSP sim- 
plifies input by producing the sensitivities of all reacting spe- 
cies mole numbers. The names TEMP, DENSITY, and PRES- 
SURE are required for sensitivity coefficients of temperature, 
density, and pressure, respectively. If the dependent variable 
list includes a variable that is constant for the problem (e.g., 
an inert species mole number), its name will be deleted from 
the list and sensitivities (which are all constant) of this vari- 


able will not be generated. Finally the word ALL in the first 
three columns of a variable field can be used to generate sen- 
sitivities of all nonconstant variables — all reacting species 
mole numbers and any or all of the quantities temperature, 
density, and pressure that vary during the problem. The end 
of the dependent variable list is indicated by either a blank 
line or the word END in the first three columns of any vari- 
able field. If the last line of the list contains exactly eight 
names, the next line must either be blank or contain the word 
END in columns 1 to 3. 

If initial condition sensitivities are to be computed, the re- 
quired data must be preceded by a line containing the word 
INIT in columns 1 to 4. These data, which are names of vari- 
ables with respect to whose initial values sensitivity coeffi- 
cients are needed, are written in exactly the same way as the 
dependent variable names. This list may include names of 
inert species and other quantities that are constant. Thus the 
variable name ALLSP will produce sensitivities with respect 
to the initial mole numbers of all reacting and all inert spe- 
cies. Similarly the name ALL will generate initial value sen- 
sitivities for all variables. But because pressure is not an 
internal variable, sensitivity coefficients with respect to its 
initial value cannot be requested. However, the normalized 
sensitivity coefficients with respect to the initial pressure are 
equal to, and therefore can be obtained from, those with re- 
spect to the initial density. Finally, if temperature is assigned 
as a nonconstant function of time, sensitivities with respect to 
its initial value cannot be computed. 

Type (3) data must be included if sensitivity coefficients 
with respect to rate coefficient parameters are required. These 
data, identified by a line containing the keyword REAC in 
columns 1 to 4, are specified in a namelist called SENRXN, 
which must follow the keyword line. This namelist contains 
logical variables for selecting the rate coefficient parameters 
with respect to which sensitivity coefficients are required. 
Reactions for which sensitivity analysis is to be performed 
and the output format for these sensitivity coefficients are 
also selected here. The namelist variables and their descrip- 
tions are given in table 11.17, with the default values under- 
lined. 

For a nonconstant-temperature problem any of the logical 
variables SENSAJ, SENSNJ, and SENSEJ may be set equal 
to TRUE. That is, sensitivity coefficients with respect to any 
of the rate coefficient parameters Aj, nj , and Ej or cj can be 
computed. However, for a constant-temperature problem the 
normalized sensitivity coefficients with respect to all rate 
coefficient parameters are equal to one another (and equal to 
the normalized sensitivity coefficients with respect to the rate 
constant, see chapter 4 of part I). Hence sensitivity coeffi- 
cients with respect to only Aj are produced, regardless of the 
rate coefficient parameters specified. The reaction numbers 
for which sensitivity coefficients are to be computed must be 
entered into the array RXNUM. The logical variable 
ALLRXN may be set equal to TRUE and RXNUM omitted, 
if sensitivities are required for all reactions. 
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TABLE 11.17 — DESCRIPTION OF NAMELIST SENRXN 


Variable 

Variable 

Value 

Explanation 

name 

type 



ALLRXN 

Logical 

TRUE 

Sensitivities must be computed for all reactions 


FALSE 

Sensitivities are required for only reactions listed in RXNUM 

ORDER 

Logical 

TRUE 

Nonzero normalized sensitivity coefficients and reaction 
numbers are to be listed in decreasing order of importance 
for each rate coefficient parameter 




FALSE 

Reaction importance list is not required 

OUTPUT 

Logical 

TRUE 

Complete tables of normalized sensitivity coefficients are to 
be printed for each rate coefficient parameter 



FALSE 

Only reaction importance list is to be printed 

RXNUM 

Real 


Reaction numbers with respect to whose rate coefficient 
parameters sensitivities are required; not needed if ALLRXN 
is set equal to TRUE 

SENSAJ 

Logical 

TRUE 

Sensitivities with respect to rate coefficient parameter A- 
are required 



FALSE 

Sensitivities with respect to A- are not required 

SENSEJ 

Logical 

TRUE 

Sensitivities with respect to rate coefficient parameter £• 
(or cj) are required 



FALSE 

Sensitivities with respect to E- (or cj) are not required 

SENSNJ 

Logical 

TRUE 

Sensitivities with respect to rate coefficient parameter n } 
are required 



FALSE 

Sensitivities with respect to n- are not required 


As described in chapter 12 (see section 12.3), sensitivity 
coefficients with respect to rate coefficient parameters can be 
printed in two ways, indexed by either reaction number or 
dependent variable name, with the nonzero normalized sensi- 
tivity coefficients listed, along with the reaction numbers in 
decreasing order of importance. The first type of output is the 
default format; it can be switched off by setting the logical 
variable OUTPUT equal to FALSE. The second type of out- 
put can be obtained by setting the logical variable ORDER 
equal to TRUE. If the user sets OUTPUT = FALSE but fails 
to set ORDER = TRUE, the code automatically performs the 
latter operation so that some output is generated. 

11.3.11 FINIS Line 

The last line of the problem data file must contain the 
word FINIS in columns 1 to 5. This line will follow the ini- 
tial composition list or namelist SOLVER or the sensitivity 
analysis data, depending on the problem type and whether the 
sensitivity analysis option is selected. 


11.4 Problem Data File for 
Multiple Cases 

If several problems are to be solved during one run, the 
first case data must follow exactly the same format given in 
section 1 1 .3 for a single case. For the second and subsequent 
cases the required data, which must be placed immediately 
after the first case data, depend on the information, if any, 
that can be used from the previous case (or cases). The code 
was designed to minimize the amount of input data, espe- 
cially when they are the same for two or more consecutive 
cases. The data that are saved from any one case depend on 
the value assigned in the next case data for an option called 
ACTION. The main purpose of providing this option was to 
eliminate typing in a reaction mechanism when it either is 
identical, or can be obtained by adding reactions, to that used 
for the previous case. We now describe, in the order that they 
must appear in the problem data file, the information that 
must be provided for each new problem. A summary of the 
necessary input is given in figure 1 1 .4. 
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c 


Problem data file for first case’ 


C 


x 


D 


Title line 


j 


C 


ACTION line 


3 


Yes (entirely new problem, including 


reaction mechanism) 


No (save reaction mechanism data, options, and 


\CTION\some additional quantities from previous case^ 
Vf NEW?/ ; 


f Reactions, rate coefficient parameters 

vs ' 


^and new third-body collisional efficiencies 


X 


meters/N 
iciencies ) 


Yes (change parameters) 
in one or more reactions) 


ACTION line 


Yes (add new reactions to previous 
mechanism and/or new inert species) 


C ( New ) reactions, rate coefficient parameters,^ 
x. an ^ third-body collisional efficiencies J 



No (use previously 
specified rate parameters) 


ACTIO N\No: ACTION 
,= ADD? 


(use previous 
mechanism) 


REPEAT 


C 


x 


(New) inert species 


E 


3 


(i ntegration variable) (^ Assigned vari able) ( Input units ) ( Output unit. U e..., >> 

nistanra ri ^ / 


Distance 

Time 


Pressure 

Area 


cgs 

U.S. customary 
SI 


cgs 

U.S. customary 
SI 


x 


C Problem type and options* ^ 


z 




C Temperature profile options ^ 


( Perfectly stirred reactor problem type and options 


( Initial conditions* ) 


X 


( integration controls ^ 

_ x 


( Sensitivity analysis data* ") 


X 


C 


FINIS line 


J 


Yes 



( End of problem \ 
data file J 


Figure 11.4. Structure of problem data file for multiple cases. (Details of items marked 


with asterisk are given in figure 1 1 .3.) 
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11.4.1 Title Line 

The first line following the FINIS line for the previous 
case contains the title message described in section 11.3.1 
and may be blank. 

11.4.2 ACTION Line 

The next line of the data set must contain the value for the 
ACTION option, which controls what data, if any, are saved 
from the previous case. The possible values are NEW, 
CHANGE, ADD, and REPEAT One of the four words must 
be written on this line, starting in column 1. 

The word NEW tells the code not to save any data from 
the previous problem. This option should be used when the 
reaction mechanism is different from that previously read in 
and cannot be constructed from it by adding reactions. In this 
case, all options and variables related to problem specifica- 
tion and control are reinitialized. The remainder of the prob- 
lem data must be prepared by using exactly the same format 
as that given in sections 1 1 .3.2 to 11.3.11 for a single case. 

If any other value (i.e., CHANGE, ADD, or REPEAT) is 
assigned for ACTION, the reaction mechanism, the rate coef- 
ficient parameters, the third-body efficiencies, and the inert 
species from the previous case are saved, as are the options 
ACON, COMBUS, CONC, EXCHR, HTRAN, ORDER, 
OTTO, PCON, QMREAD, ROCKET, RHOCON, SENCAL, 
SENSTD, SHOCK, TASS, TCON, WELSTR, WSFLOW, 
and WSRHTR. In addition, any of the following quantities 
that were required for the previous problem are saved: 
ATHROT, BORE, END, HTO, HT1 , HT2, HT3, HT4, 
IPRINT, PC, RPM, STROKE, TINY, TOTMAS, and 
TWALL; BETA, D, ETA, LSUBM, and VISC; DELMD, 
DELT, DOTMAX, DTMAX, MPR, TMPMIN, VOLUME, 
WSRHTO, WSRHT 1 , WSRHT2, WSRHT3, and WSRHT4; 
profiles for assigned variable (pressure or area) and tempera- 
ture; and the print station list. (Note that if a value for any 
variable not needed for the problem is specified, this variable 
will not be saved.) 

None of the above quantities needs to be reset unless either 
a new value is required or a different option is selected. In the 
latter case the previously specified option must be switched 
off. For example, if the previous problem required the com- 
putation of heat transfer rates and so HTRAN had been set 
equal to TRUE in PROB and the present case is adiabatic, 
HTRAN must now be set equal to FALSE in PROB. Simi- 
larly, if a different heat transfer model is to be used, 
QMREAD must be reset accordingly, and the data required 
by the new model supplied. Another illustrative example is as 
follows: Suppose the previous case had involved a perfectly 
stirred reactor problem followed by a plug-flow problem, and 
therefore the variable WSFLOW (and maybe, WELSTR) had 
been set equal to TRUE in PROB. If the present case does 
not require a flow problem calculation, WSFLOW must be 


11.4 Problem Data File for Multiple Cases 
set equal to FALSE in PROB, but WELSTR need not be 
given. Of course, if a totally different problem type is to be 
considered, both WELSTR and WSFLOW must be set equal 
to FALSE, and the appropriate option switch supplied. 

If a different problem type is specified, any option selected 
previously that might either be in conflict with, or is not al- 
lowed by, the new problem must be switched off; otherwise, 
an error exit will occur. An example is sensitivity analysis, 
which can be performed only for a static problem. Thus, if a 
static problem for which sensitivity analysis had been se- 
lected by setting SENCAL equal to TRUE in PROB is fol- 
lowed by a flow problem, SENCAL must now be set equal to 
FALSE in PROB. 

The CHANGE option allows the user to change any rate 
coefficient parameter and/or any third-body efficiency for 
any reaction previously given. This option may also be used 
to change the reversibility of a reaction and/or the form of the 
rate coefficient expression. In any case the reactions whose 
parameters are to be modified must be listed, one per line, 
immediately after the ACTION line. Each reaction must be 
given exactly as before, using the format given in section 
11.3.2. In addition, values must be specified for all three rate 
coefficient parameters, even those with the same values. 

If collisional efficiencies are to be changed for a third- 
body collisional reaction, lines containing the word 
THIRDBODY and the species names and efficiencies must 
follow the reaction, as described in section 1 1 .3.2. Only spe- 
cies whose efficiencies are different from those previously 
specified need to be listed. Note that the input data must con- 
tain any species whose new, but not old, efficiency is unity. 
Such species will be deleted from the third-body list. Simi- 
larly the list will be expanded to include every species whose 
efficiency is changed from unity. Such species and their new 
efficiencies must be included in the problem data. Finally a 
new species — one that was not considered for the previous 
problem — can be included in the third-body list by taking the 
following actions: The new species and its third-body 
efficiency are given, as discussed previously. The ADD 
option, described later, is then used to add the new species to 
the species list by means of either new reactions for a react- 
ing species or the inert species list. 

However the CHANGE option is used, the end of the reac- 
tion list is indicated by a line that either is blank or contains 
the word END in the First reactant field (i.e., columns 4 to 6). 
The reaction list must be followed by another ACTION line, 
which must contain either the word ADD or REPEAT, start- 
ing in column 1 . 

The ADD option enables the user to add new reactions to 
the previous mechanism and thus possibly new reacting spe- 
cies. If this option is used, the value of the logical variable 
RXNTST from the previous case is also saved. The new reac- 
tions are entered, one per line, immediately after the 
ACTION line. The information required on each reaction line 
and its format are identical to those described in section 
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11.3.2. The end of the new reaction list is signaled by a line 
that either contains the word END in columns 4 to 6 or is 
blank. 

Provision has also been made to add new inert species to 
the mixture. After the reaction list the next line or lines must 
contain the new inert species, using the same format as for 
the first case (see section 1 1.3.3). Species that were declared 
inert in the previous case (or cases) need not be listed. The 
end of the inert species list is indicated by a species field that 
either is blank or contains the word END in the first three 
columns. If no new inert species is to be considered, the 
reaction list must be followed by a line that either contains 
the word END in columns 1 to 3 or is blank. 

The ADD option can be used solely to add new inert spe- 
cies. In this case the ACTION line must be followed by a 
blank line or one containing the word END in columns 4 to 
6. The new inert species list is then entered, as described 
previously. 

The REPEAT option tells the code to use exactly the same 
reaction mechanism as that for the previous case. The list of 
reacting and inert species is also unchanged. However, some 
reaction information may have been changed by means of the 
CHANGE option. 

The following information must follow either the REPEAT 
line or, if the ADD option has been used, the inert species 
list. 

11.4.3 Integration and Assigned Variables, 

Units, and Fuel Name Line 

None of this information is saved from the previous case; 
therefore the next line of the problem data file must list the 
integration and assigned variables, the input and output units, 
and possibly the fuel name. The format is identical to that 
used for the first case (see section 1 1 .3.4). 

11.4.4 Problem Data, Related Options, Heat 
Transfer Data, and Output Controls 

The variables specifying the problem type and options 
(i.e., namelist PROB) must be supplied next. (The variables 
and options that are set in this namelist are described in sec- 
tion 11.3.5.) As discussed in section 11.4.2, previously 
selected options that are not required or cannot be used must 
be switched off, and those needed for the new case must be 
switched on. In addition, new variables required for the prob- 
lem and previously specified variables with new values must 
be set. However, previously specified variables that are not 
needed for this case do not have to be listed. The same rule 
applies to previously specified variables with the same values 
as before. 

If no new option or variable is required and the previously 
assigned variables need not be changed, a dummy line simply 
indicating the beginning and ending of the namelist may be 


inserted. It must be remembered that variables which are both 
required by and introduced into a NEW case and then into 
successive CHANGE and/or REPEAT (or ADD) cases are 
saved until overwritten by the new user-supplied values. 
Thus until the NEW option is again selected, the user has 
access to the most recently specified value for every quantity 
that is saved (see section 11.4.2 for list). 

11.4.5 Assigned-Temperature Profile 

If the temperature is assigned, the namelist TMPDAT, de- 
scribed in section 1 1.3.6, must follow PROB. The variables 
that must be set in TMPDAT depend on the options and vari- 
ables, if any, that were previously assigned in this namelist. If 
this is the first assigned-temperature problem since the last 
NEW option was selected, TMPDAT must contain the vari- 
ables described in section 1 1.3.6. However, if the temperature 
had been assigned previously, only new options, new vari- 
ables, and variables with new values need to be listed. If no 
new option or variable is required and the previously as- 
signed variables need not be changed, a dummy line simply 
indicating the beginning and ending of the namelist may be 
entered. 

11.4.6 Perfectly Stirred Reactor Problem Data 

If a PSR calculation is required, the namelist WSPROB, 
described in section 11.3.7, must follow PROB. The variables 
that must be set in WSPROB depend on the options and vari- 
ables, if any, that were previously assigned in this namelist. If 
this is the first PSR problem since the last NEW option was 
selected, WSPROB must contain the variables described in 
section 11.3.7. However, if a PSR problem had been speci- 
fied previously, only new options, new variables, and vari- 
ables with new values need to be listed. If no new option or 
variable is required and the previously assigned variables 
need not be changed, a dummy line simply indicating the 
beginning and ending of the namelist may be inserted. 

11.4.7 Initial Conditions 

The initial values of thermodynamic and fluid dynamic 
variables must be given in namelist START, which must fol- 
low PROB, TMPDAT, or WSPROB. No initial condition is 
saved; therefore the user must supply all the required input 
data, which depend on the problem type, as discussed in sec- 
tion 1 1.3.8. The namelist must be followed by the initial mix- 
ture composition list, as described in section 1 1.3. 8. 6. 

11.4.8 Local Error Tolerances and Other 
Integration Controls 

Following the initial composition list, the integration con- 
trols are given in namelist SOLVER, if necessary, as 
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explained in section 11.3.9. If this is the first problem for 
which SOLVER is either required or given since the last 
NEW option was selected, the namelist must contain vari- 
ables for which nondefault values are to be used. However, if 
integration controls had been assigned previously, only new 
variables and variables with new values need to be set. If the 
previously assigned variables, default or otherwise, need not 
be changed and no new variable is required, a dummy line 
simply indicating the beginning and ending of the namelist 
may be given. 


11.4 Problem Data File for Multiple Cases 

11.4.9 Sensitivity Analysis Data 

If sensitivity analysis is required for this case, all of the 
data described in section 1 1.3.10 must follow SOLVER 
because none of this information is saved. 

11.4.10 FINIS Line 

The input data must end with a line containing the word 
FINIS in columns 1 to 5. 
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Chapter 12 

Description of Output 

12.1 Introduction 

For all problem types the input information is printed in 
two ways. First, an exact image of the problem data file, 
except any thermodynamic coefficients included here, is pro- 
duced for each case. Blank lines in the input file are identi- 
fied by the words BLANK LINE. To assist the user in check- 
ing input data for errors, the code prints column numbers 
from 1 to 80 at the top of this image. Second, more detailed 
input information, including problem type and options se- 
lected, is printed, usually in the output units specified by the 
user. This material is given in the following order: 

(1) Lists of elements and reacting and inert species consid- 
ered for the problem are generated, as are the thermodynamic 
data, molar mass, heat of formation (in calories per mole) at 
25 °C, and, if required for the problem, transport data for 
each species. 

(2) If an equilibrium or shock calculation is performed, the 
results are printed in the format described in section 12.4. 

(3) The reaction mechanism and forward rate coefficient 
parameters, the third-body efficiencies, and the input and out- 
put units are printed. 

(4) For a perfectly stirred reactor (PSR) problem the reac- 
tor volume, the mass flow rate either for the first solution of 
an assigned-mass-flow-rate problem or to start the iteration 
for an assigned-temperature problem, the problem type, and 
the input data required for the calculation are given. For all 
other problem types the assigned variable and temperature 
profiles, the number of ordinary differential equations 
(ODE’s), the integration controls, the sensitivity analysis 
data, including the normalization factors for any rate coeffi- 
cient parameters selected, and the output control information 
are printed. 

(5) The heat transfer data if any, the simplified- 
composition input data if this option is selected, and numbers 
of reacting and inert species are printed. 


P(W*ttf*C PAGE BLANK NOT FILMED 


(6) The initial values of many variables and their deriva- 
tives, described in section 12.2.1 are then listed. 

(7) Finally, the central processing unit (CPU) time required 
so far, that is, to initialize the code, is given in seconds. 

The output information related to problem solution 
depends on the problem type and options selected. For each 
problem type certain standard material is automatically gen- 
erated at each print station. For static and flow kinetics and 
PSR problems optional output may be obtained, either in 
place of some standard quantities or in addition to regular 
output. If the sensitivity analysis option is selected, addi- 
tional variables are printed. We now discuss the solution in- 
formation that is generated for each problem type and related 
option. 


12.2 Static and Flow Kinetics Problems 

12.2.1 Standard Output 

For a static or one-dimensional flow problem, including 
that following cither an incident shock or a PSR computation, 
the following standard information is listed if no option re- 
lated to output information specification is selected in 
namelist PROB: 

(1) Reaction time t (gas-particle time for shock reaction); 
flow cross-sectional area A (for a shock reaction the nor- 
malized area A!A S , where A s is the shock tube cross- 
sectional area); and_axial position x 

(2) Pressure p\ velocity V; density p; temperature T\ and 
mass flow rate m (mass flow rate per unit cross-sectional 
area, i.e., mass flux m\ for a shock reaction) 

(3) The thermodynamic and fluid mechanic properties 
(a) Mass-specific entropy s 
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NS 




i=l 


- — In C: - In pM 
R 1 H 


(12.1) 


where R is the universal gas constant, NS is the total 
number of (reacting and inert) species, a, is the 
mole number of species i (i.e., moles of species i per 
unit mass of mixture), s? is the standard-state (1 atm) 
molar- specific entropy of species i, and M w is the 
mixture molar mass 


(e) Total number of functional (i.e., derivative) 
evaluations NFE 

(0 Total number of Jacobian matrix evaluations NJE 
(This number is equal to the total number of LU- 
decompositions of the iteration matrix.) 

(6) For each species i 

(a) Molar concentration C/ 

C, = pa, (12.6) 

(b) Mole fraction x/ 


(c) Net species production rate per unit volume due 
to all reactions W/ 


M ~=w 


i=I 


( 12 . 2 ) 


jc, =a,Af M 


(12.7) 


(b) Mach number JA 


NR 


h, =y% 


( 12 . 8 ) 


, = (12.3) 

pRT/M w 

where y is the frozen specific heat ratio of the mix- 
ture 



and Cp is the mixture mass-specific heat at constant 
pressure 

NS 

(l25) 
i - i 

where c pi is the constant-pressure molar-specific 
heat of species i. 

(c) Specific heat ratio y, equation (12.4) 

(d) Mixture mass-specific enthalpy h y equation (8.36) 

(e) Constant-pressure specific heat of the mixture c p , 
equation (12.5) 

(4) For a problem with heat transfer the heat transfer rate 
per unit mass of mixture Qjm for a static problem or the 
heat transfer per unit mass of mixture per unit length in 
the flow direction Q'fm for a flow problem 

(5) Integration indicators 

(a) Number of integration steps from last print INST 

(b) Average step size since last print AVH 

(c) Order of the integration method used on the last 
step NQ 

(d) Total number of integration steps NSTEP 


;=l 

where NR is the total number of reactions and co^, 
the net molar formation rate of species i per unit 
volume by reaction j, is given by equation (8.58). If 
species i is being destroyed, W t is negative. 

(7) For each reaction j the forward rate coefficient kp 
equation (8.3) or (8.4); the net reaction conversion rate 
Xj, equation (8.56); and the equilibration factor Eqjy 
equation (8.61). For a third-body collisional reaction 
the kj printed is for the reference rate coefficient 
formula. 

(8) Derivatives of temperature, density, and for a flow 
problem velocity with respect to the integration variable 

(9) Mixture molar mass M ^ equation (12.2) 

(10) Total energy exchange rate X // 

NR 

*H='L X j AH 298,7 (119) 

j = I 

where A//^98v standard-state enthalpy change for 
the yth reaction at a temperature of 298 K 

NS NS 

A H%mj = X v "j (298 K) -]T v'j |>? (298 K) (1 2. 1 0) 

i=\ i=\ 

Here vjj and vjy are, respectively, the stoichiometric co- 
efficients of reactant species i and product species i in 
reaction j, and (i/(298 K) is the standard-state, molar- 
specific enthalpy of species i at 298 K. The quantity 
X/y is proportional to the net heat release rate for the 
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12.2 Static and Flow Kinetics Problems 


entire complex reaction and may be useful in studying 
ignition processes. 

(11) Mass fraction sum S m 

NS 

02 -”) 

/=! 

where M w j is the molar mass of species i. If at any 
time S m is not close to unity, we have found that con- 
tinued integration sometimes produces significantly in- 
accurate results. Therefore, if S m is different from unity 
by more than 5xl0“ 5 , an error exit is taken. This error 
exit means one or more of the following: the integra- 
tion method is inappropriate, the local error tolerances 
must be reduced, and the reaction mechanism contains 
one or more reactions that do not satisfy atom and/or 
charge balance requirements. 

(12) The CPU time in seconds used both since the last out- 
put of results ICPU and so far for the problem CPU 

For each of the above dimensional quantities, except the 
average step size, which has the same units as the integration 


variable, and the CPU time, which is always given in sec- 
onds, we list in table 12.1 the units used on output for the 
three systems of units included in the code. In this table f; is 
the integration variable, time or distance. 

After the problem has been successfully completed, the 
following summary of the computational work required to 
solve the problem is printed: total number of integration 
steps, total number of derivative evaluations, total number of 
Jacobian matrix evaluations and LU-decompositions of the 
iteration matrix, and total execution time in seconds. In addi- 
tion, the total CPU time TCPU required for code initializa- 
tion, input, processing of input and output data, problem 
solution, and output is given in seconds. 

12.2.2 Optional Additional Output 

The optional output that is produced depends on the output 
information specification options selected in namelist PROB 
(see table 11.5 and section 11.3.5.5). In particular, setting 
nondefault values for the logical variables CONC, DBUGO, 
EXCHR, ORDER, and ROCKET produces the following in- 
formation: 

(1) Species mass fractions {y;} 


TABLE 12.1— UNITS FOR OUTPUT VARIABLES IN THE THREE SYSTEMS 
ALLOWED BY CODE 


Variable 


Units 



cgs 

(internal) 

US. 

customary 

SI 

Tims 

s 

s 

s 

Area 

7 

cm 

ft 2 

__2 

m 

Axial position 

cm 

ft 

m 

Pressure 

atm 

lbf/ft 2 

N/m 2 

Velocity 

cm/s 

ft/s 

m/s 

Density 

g/cm 3 

lb/ft 3 

kg/m 3 

Temperature 

K 

°R 

K 

Mass flow rate 

g/s 

lb/s 

kg/s 

Mass flux 

g/s-cm 2 

lh/s-ft 2 

kg/s-m 2 

Specific entropy 

cal/g-K 

Btu/lb-°R 

J/kg-K 

Specific enthalpy 

cal/g 

Btu/lb 

J/kg 

Constant-pressure specific heat 
Heat loss term: 

caJ/g-K 

Btu/lb-°R 

J/kg-K 

fe/m 

cal/s-g 

Btu/s-lb 

J/s-kg 

fe'l'm 

cal/g-cm 

Btu/lb-ft 

J/kg-m 

Species molar concentration 

mole/cm 3 

lb mole/ft 3 

kmole/m 3 

Species production rate 

mole/cm 3 -s 

lb mole/ft 3 -s 

kmole/m 3 -s 

Reaction rate coefficient 

cgs units 3 

cgs units 3 

cgs units 3 

Net reaction conversion rate 

mole/cm 3 -s-p 2 

lb mole/ft 3 -s-p 2 

kmole/m 3 -s-p 2 

Temperature derivative dT/dfc, 

K/unit ^ 

°R/unit ^ 

K/unit £ 

Density derivative dp/d^ 

g/cm 3 -unit £ 

lb/ft 3 -unit ^ 

kg/m 3 -unit £ 

Velocity derivative dVid £ 

cm/s -unit £ 

ft/s -unit ^ 

m/s-unit £ 

Mixture molar mass 

g/mole 

Ib/lb mole 

kg/kmole 

Net energy exchange rate 

cal/cm 3 -s-p 2 

Btu/ft 3 -s-p 2 

J/m 3 -s-p 2 


“Units for first-order reaction are s“*. 

Units for bimolecular reaction are cm 3 /mole-s. 
Units for termolecular reaction are cm 6 /mole 2 -s. 


15 



12. Description of Output 

y t =< *i M w j> i = 1,...,NS (12.12) 

are listed in place of molar concentrations {C f }, equa- 
tion (12.6), if CONC is set equal to FALSE. 

(2) A complete listing of the {a,}, derivatives of {a/} with 
respect to the integration variable, and {(0 /,}, equation (8.58), 
is provided if DBUGO is set equal to TRUE. This informa- 
tion is useful for debugging and is always given in cgs units. 

(3) Setting EXCHR equal to TRUE will produce the net 
energy exchange rates {Xfij} 

X H J = Xj AH° ln j (12.13) 

instead of the {Xj}, equation (8.56). 

(4) An ordered list of nonzero net formation rates { City } , 
equation (8.58), is printed (in moles per cubic centimeter per 
second) for each species i and each reaction j if ORDER is 
set equal to TRUE. 

(5) If rocket performance parameters are required for a 
flow problem (i.e., if ROCKET is set equal to TRUE), the 
following variables are tabulated: 

(a) Specific impulse hp 

u P = — 02.14) 

Sc 

(b) Vacuum specific impulse / vac 

',«=' sp + — «2I5) 

m 

(c) Area ratio A r 

A r =4- (12.16) 

A t 

(d) Characteristic velocity c * 

c*= PcA J 8c (12.17) 

m 

(e) Thrust coefficient Cf 

Cf= 4 (12-18) 

J c * 

In these equations g c is a units conversion factor, A t is the 
nozzle throat area, and p c is the rocket combustion chamber 


pressure. Irrespective of the output units selected by the user, 
/ sp and / vac are given in both SI and U.S. customary units, 
and c* is printed in feet per second. 

12.3 Sensitivity Analysis 

Two formats, one default and the other optional, are avail- 
able for printing the normalized sensitivity coefficients with 
respect to the rate coefficient parameters. The formats are 
selected by means of the logical variables OUTPUT and 
ORDER, as described in section 1 1 .3.10. The default output 
control, corresponding to OUTPUT = TRUE, produces a 
table of all normalized sensitivity coefficients {(5^)}, includ- 
ing those set equal to zero because their magnitudes are 
smaller than TINY (see section 1 1 .3.5. 1 .5). The first column 
of this table gives the reaction numbers, which are listed ei- 
ther in the same order as that specified in the array RXNUM 
or serially if ALLRXN has been set equal to TRUE (see sec- 
tion 11.3.10). The dependent variable names are printed in 
the first row. The species, if any, are tabulated in the order 
that they appear in either the list of dependent variable names 
or the reaction mechanism if either keyword ALLSP or ALL 
has been used (see section 11.3.10). They are followed by 
any nonconstant variables, such as temperature, density, and 
pressure. Along every subsequent row the reaction number 
and the normalized sensitivity coefficients of the appropriate 
dependent variables with respect to the relevant rate coeffi- 
cient parameter are listed. 

At the user’s option a differently indexed table is pro- 
duced, either in addition to, or in place of, the default format. 
The optional table, selected by setting ORDER equal to 
TRUE, is indexed by dependent variable names, reaction 
numbers, and normalized sensitivity coefficients along the 
rows. The order used for the names is the same as that 
described for the default format. For each dependent variable 
the reaction numbers are listed in order of decreasing impor- 
tance, that is, decreasing magnitude of the { (Sy ) } . The nor- 
malized sensitivity coefficient of the dependent variable 
listed in the first column with respect to the appropriate rate 
coefficient parameter is placed directly under the reaction 
number. Neither the {(£/,)} that have been set equal to zero 
nor the corresponding reaction numbers are printed. 

For both output formats a separate table is produced for 
each rate coefficient parameter selected by the user. The 
reaction time, the rate coefficient parameter name, and the 
procedure used to normalize the results with respect to that 
parameter are given. 

Only the default format is used for initial condition sensi- 
tivities. The first column of the table gives the names of the 
variables with respect to whose initial values sensitivities are 
computed. The dependent variables are listed along the first 
row. The order used for both quantities is exactly the same as 
that described earlier for the dependent variables. The sec- 
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ond and subsequent rows contain the appropriate { (Sy) } . The 
normalization procedures are given for these sensitivities 
also. 

If sensitivity coefficients of the temporal derivatives {(Sy)} 
are computed, exactly the same output formats as described 
previously are used. In this case also, the normalization pro- 
cedures are printed for both initial condition and rate coeffi- 
cient parameter sensitivities. 

After successful completion of the problem summary 
information regarding the computational work required for 
sensitivity analysis is given. The following quantities are 
printed: total number of steps, total number of derivative 
evaluations, and total number of Jacobian matrix evaluations 
and LU-decompositions of the iteration matrix. Finally the 
dimensions of the real and integer work arrays (i.e., total stor- 
age) used for integrating the kinetics and sensitivity ODE’s 
are listed. 

12.4 Equilibrium and Shock 
Calculations 

The output format is the same for the chemical equilib- 
rium, equilibrium shock, and frozen shock states. First, the 
initial and final state values and the ratio of final to initial 
state values are listed for each of the following variables: 

(1) Pressure p 

(2) Gas velocity V 

(3) Density p 

(4) Temperature T 

(5) Mixture mass-specific enthalpy h, equation (8.36) 

(6) Mixture mass-specific internal energy u 

u = h-RT!M w (12.19) 

(7) Constant-pressure specific heat of the mixture 
(dhfdT) py which reduces to equation (12.5) for both 
initial states and the final state of the frozen shock 
computations 

(8) Mixture mass-specific entropy 5, equation (12.1) 

(9) Mach number oil 

oil = V/c (12.20) 

where the sonic velocity c is computed as follows: 

c = Jn?77M w (12.21) 

where T depends on the problem type and the state (i.e., 
initial or final). For both equilibrium problems the final 
state T is given by 


12.5 Perfectly Stirred Reactor Problem 

r = — — 7 (12.22) 

r dlnv^ d\nv^ / M w f dh ' 

,ainpj r + [ainrj p / r [ar ) p 

where 1/ is the mixture mass-specific volume. For all ini- 
tial states and the final frozen shock state T reduces to 
the frozen specific heat ratio y, equation (12.4). 

(10) The quantity T defined in equation (12.22) 

(11) The sonic velocity c, equation (12.21) 

The initial and final velocities and Mach numbers are zero 
for the chemical equilibrium calculation. For both variables 
the ratio of final to initial values is set equal to unity. 

The preceding list of variables is followed by the final 
state mixture composition, expressed as mole fractions {*, }, 
equation (12.7). The following final state thermodynamic 
properties are then printed: mixture molar mass A/*., 
equation (12.2); and the derivatives (3ln W3ln T) p and 
(3ln v/d In p)j. (For the frozen shock problem (3ln y/9ln T) p 
= 1 and (<3ln v/3ln p)j = -1 .) 

Finally a summary of the computational work required to 
solve the problem is listed. The quantities printed include the 
total number of iterations NITER and the execution time 
CPU in seconds. 


12.5 Perfectly Stirred Reactor Problem 

12.5.1 Standard Output 

For an assigned-mass-flow-rate or assigned-temperature 
problem the following standard information is listed: First, 
the results of the equilibrium computation are printed in 
exactly the same format as that given for a kinetics problem 
in section 12.2.1. This information is followed by a summary 
of the computational work required for the equilibrium calcu- 
lation and the initial estimates for temperature and species 
mole numbers {G/}. 

For both problem types the following quantities are listed 
after the first successful convergence: 

(1) Initial and present values of pressure p\ temperature T\ 
mixture mass-specific entropy s y equation (12.1); density 
p; mixture mass-specific enthalpy h, equation (8.36); 
constant-pressure, mass-specific heat c p , equation (12.5); 
molar mass Af H >, equation (12.2); and specific heat ratio 
y, equation (12.4). The ratio of present to initial values 
is also given for each variable. 

(2) Initial and present values of both the mole {*,} and 
mass { y f } fractions of each species, equations (12.7) and 
(12.12), respectively 

(3) For a problem with heat transfer the heat loss term Qjn\ 
where Q is the heat loss rate and m is the mass flow rate 
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(4) The reactor volume Qi and the mass flow rate 

(5) The ratio m/ty the reactor average residence time t r 
(= p^V/m), and the number of iterations needed for con- 
vergence NITER 

The above information is also printed after every MPR 
(see section 11.3.7) successful convergence and, irrespective 
of MPR, after the last successful convergence for the prob- 
lem, that is, the one at the desired exit conditions. After the 
last convergence the total number of iterations and the CPU 
time in seconds required for the PSR calculation are given. If 
output is not required after any convergence, the following 
quantities are printed: convergence number, NCONV; num- 
ber of iterations; mass flow rate; temperature; and residence 
time. 

12.5.2 Optional Additional Output 

The optional additional output that is produced depends on 
the values assigned for the logical variables DBUGO in 
namelist PROB and RITE in namelist WSPROB (see sec- 
tions 11.3.5.5 and 11.3.7). If debug output information has 
been asked for (i.e., if DBUGO has been set equal to TRUE), 
the following variables are given on each iteration: iteration 
number ITER; temperature; mass flow rate; net species 
production rate per unit volume { W/ } , equation (12.8); the 
Newton-Raphson functionals {^}, called {TZ(I)} in the out- 
put; the sum of the squares of the {^}, FSUM; the FSUM 
value from the previous iteration PFSUM, called previous 
FSUM in the output (for the first iteration PFSUM is 


assigned a value of zero); either the log correction Ain T for 
an assigned-mass-flow-rate problem or Ain m for an 
assigned-temperature problem; and the sum of the species 
mole numbers G m 

NS 

a m =£a, (12.23) 

1 = 1 

The above list is followed by the species mole numbers {a,} 
and their log corrections {Ain a,}; the underrelaxation factors 
A and A\ used to control the corrections (see chapter 7 of 
part I); and the mass fraction sum S m , equation (12.11). 

If reaction rate information is required (i.e., RITE has been 
set equal to TRUE), the following quantities are printed on 
every iteration: the net reaction rates per unit volume {rj} 9 
equation (8.57); and the species net molar formation rates per 
unit volume due to each reaction {(Oy), equation (8.58). 

Irrespective of the output units selected by the user, {rj} 
and {to ij] are given in cgs units. Both quantities are also gen- 
erated if any PSR calculation is abandoned because success- 
ful convergence could not be achieved after 75 iterations. 

12.6 Summary of Output Information 

For the user’s convenience the output information gener- 
ated for each problem type and option included in the code is 
summarized in table 12.2. 
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TABLE 12.2.— SUMMARY OF OUTPUT 


Problem type or 
option 

Information 

type: 

standard or 
optional 

Keyword and value 
required to either 
switch off standard 
output or switch on 
optional output 

Namelist 

where 

keyword 

appears 

Variables printed® 

Kinetics only 
(static or 
one-dimensional 
flow reaction) 

Standard 



f, A or A/A s , x, p, V, p. T, m or m", s, 'M, y, h, c p , Q tm or (V/m. 
INST. AVH, NQ, NSTEP. NFE. NJE, {C,}. {jc,}, {IV,.), {*), (A - ,), 
{£„,), dT/dt,, dp/dZ,, dV/dZ,, M X H . S_, ICPU, and CPU. At problem 
end: NSTEP, NFE, NJE, CPU; and TCPU. 

Optional 

CONC=.FALSE. 
EXCHR=. TRUE 
ORDER=.TRUE. b 

DBUGO=.TRUE. b 
ROCKET =.TRUE. C 

PROB 

PROB 

PROB 

PROB 

PROB 

in place of {C,} 

{X Hj ) in place of |X ; } 

Nonzero {( 0 ^} listed in decreasing magnitude, along with corresponding 
reaction number j, for each species i 
{o,}, {dc i /d^}, and 
Pc' A r V 7 va c’ c f » A/A { 

Kinetics and 
sensitivity analysis 
(static reaction 
only) d 

Standard 

OUTPUT=.FALSE. 

SENRXN 

{(^y)} w *th respect to initial condition values, indexed by variable 
name 

K^y)} with respect to rate coefficient parameters indexed by reaction 
number 

Optional 

TINY > 0.0 
SENSTD=TRUE. 
ORDHR= TRUE. 

PROB 

PROB 

SENRXN 

If Ityi < TINY, set (Sij) = 0.0. If {(S-) } required (see below), 
same rule applies. 

indexed by initial condition name and, if OUTPUT= TRUE., by 
reaction number 

Nonzero {(5^)} and, if required, {(i^)} , with respect to rate coefficient 
parameters, listed in decreasing magnitude, along with corresponding 
reaction numbers 

Chemical equili- 
brium, equili- 
brium shock, and 
frozen shock 

Standard 



Initial and final state values and ratio of latter to former of p, V , p, T , 
A, u, ( dh/dT ) p , s, r, and c. Final state values of [x^, M w , 

(Oln v/3ln T) p , and (5ln v/Oln p) T . NITER and CPU. 

Perfectly stirred 
reactor 

Standard 



Results of equilibrium calculation, in format given above for kinetics- 
only problem; NITER and CPU required for this computation; and 
initial estimates for T and (o 4 }. After the first, then every MPRth c and 
final, successful convergence: initial and present values and ratio of 
latter to former of p , 7\ s, p, h, and c p \ initial and present values of M w , 
y, {*,}, and {y,}; £//h, V, m, mfV, and t r ; and NITER. After 
convergences for which detailed output not required: NCONV, NITER, 
m, T, and x r . At end of problem: computational work for PSR 
calculation. 


Optional j 

RITE- TRUE. b,f 
DBUGO=.TRUE. bf 

WSPROB 

PROB 

After every iteration: [rj] and { 0 ) - } 

After every iteration: ITER, T, m, { W ; \, {/}, FSUM, PFSUM, Ain Tor 
Ain m, G m , {o^}, {Ain a ( }, A, A Jt and S m 


“Except where indicated, output can be obtained in one of the following three systems of units: cgs (default), U.S. customary, and SI. All CPU times 
are given in seconds. 

^This information is given in cgs units. 

c The quantities p r , A r and c* are given in U.S. customary units, and I and / vac are given in both SI and U.S. customary units. 

< *Th e information listed for a kinetics-only problem is also generated at every print station. At end of problem NSTEP, NFE, and NJE required for 
sensitivity computations and the required lengths of the work arrays RWORK and r\VORK (see appendix C) are printed. 
c The integer variable MPR (default value, 1) is set in namelist WSPROB. 

These variables are also printed if any PSR calculation is abandoned because successful convergence is not achieved in 75 iterations. 
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Chapter 13 

Examples of Code Usage 

In this chapter we illustrate problem data file preparation 
by means of two kinetics-only test cases and one kinetics- 
plus-sensitivity-analysis problem. In addition, we examine 
the effects of local error tolerance parameters on the accuracy 
of the solutions and computational work for both types of 
calculations. The information will help the user select error 
parameters that give the desired compromise between accu- 
racy and computational speed. All results presented in this 
chapter were generated on the NASA Lewis Research 
Center's Amdahl 5870 computer using the UTS operating 
system, the Fujitsu 77 compiler (optimization level, 3), and 
double-precision arithmetic. 

13.1 Kinetics Test Cases 

13.1.1 Propane-Air, Perfectly-Stirred-Reactor- 
Plus-PJug-Flow Problem 

The first example problem involves a perfectly stirred re- 
actor (PSR) problem followed by a flow problem. The task 
is to perform an assigned-mass-flow-rate PSR computation 
for a fuel-rich (fuel-air equivalence ratio tp ~ 2) propane-air 
mixture. The air is a mixture of oxygen, nitrogen, argon, and 
carbon dioxide. The chemical mechanism involves 42 spe- 
cies and 136 reactions. Thermodynamic data for all species 
are to be taken from the standard thermodynamic data file. 
The code will be required to check the legality of the reaction 
mechanism because of its relatively large size. 

The reactor volume is 300 cm 3 . The mass flow rate, pres- 
sure, and inlet temperature are 1600 g/s, 5 atm, and 614 K, 
respectively. The inlet composition will be specified by mass 
fractions. The reactor is not adiabatic and the heat loss rate Q 
(in calories per second) is given by 

Q = —42.88 + 0.05T (13.1) 

where T is the temperature in Kelvin. 


pmammz fagf mum rtoT fumed 


The exit gas from the PSR will be expanded through a 
diverging 4-cm-long nozzle whose area profile is as follows: 

A = 15 + 20jc (13.2) 

where A is the area in square centimeters and x is the distance 
in centimeters. The throat is assumed to be at x - 0.0 cm 
and therefore it has a cross-sectional area of 15 cm 
(2.325 in. 2 ). The integration variable for the flow problem is 
distance. This problem is also nonadiabatic and the heat 
transfer rate is to be computed by using the built-in correla- 
tions and a nozzle wall temperature of 700 K. 

Computed results, including rocket performance param- 
eters, are to be printed in cgs units at x = 0.4, 2, and 4 cm. To 
make sure that the expansion computation is not started when 
the Mach number is too close to unity, an initial value of x = 
0.2 cm will be used. However, the initial reaction time is 
zero. Mass fractions are to be used for printing the mixture 
composition at the output stations. 

13.1.1.1 Problem data file . — Table 13.1 lists the required 
problem data file, which is now described. 

13. LI. LI Thermodynamic data , title line , and reaction 
mechanism data: Because this test case obtains all thermody- 
namic data from the standard thermodynamic data file, the 
first line of the problem data file has the word TAPE starting 
in column 1. The next line contains an identifying title. It is 
followed by the reaction mechanism. The hydrogen-oxygen 
mechanism is the most recent version of the scheme devel- 
oped by Brabbs and Musiak (ref. 39) and given by Bittker 
(ref. 40). The nitrogen-oxygen reactions were taken from 
reference 41, and those involving carbon monoxide and all 
hydrocarbon species from references 42 and 43. 

The blank line after the chemical mechanism signifies the 
end of the reaction list. The next line lists the inert (i.e., 
nonreacting) species argon. The next species field is blank, 
indicating the end of the inert species list. 

1 3. L 1.1.2 Problem setup data: The next line contains 
the integration and assigned variables for the flow problem 



81 



TABLE 13.1. — PROBLEM DATA FILE FOR PROPANE- AIR, PSR-PLUS-FLOW EXAMPLE PROBLEM 


TAPE 


LSENS 

PROPANE-AIR 

WELL- 

•STIRRED 

REACTOR + ROCKET 

EXP: CHAPTER 13, 

CASE 1 



C3H8 

= 

C2H5 

+ 

CH3 

5.0E+15 

0. 

83500, 

CH3 

+ 

C3H8 

= 

CH4 

+ 

C3H7 

3 . 55E+12 

0. 

10300, 



C3H7 

= 

C2H4 

+ 

CH3 

3 . OE+14 

0. 

33200. 

M 

+ 

CH4 

= 

CH3 

+ 

H 

2 . OE+17 

0. 

88000. 

H 

+ 

CH4 

= 

CH3 

+ 

H2 

1 . 26E+14 

0. 

11900. 

CH4 

+ 

02 

- 

CH3 

+ 

H02 

7.94E+13 

0. 

56000. 

0 

+ 

CH4 

- 

CH3 

+ 

OH 

1.9E+14 

0. 

11720. 

OH 

+ 

CH4 

= 

CH3 

+ 

H20 

2 . 5E+13 

0. 

5010. 

CH3 

+ 

02 

- 

CH30 

+ 

0 

2.4E+13 

0. 

28680 . 

CH3 

+ 

OH 

= 

CH30 

+ 

H 

6.3E+12 

0. 

0. 

M 

+ 

CH30 

- 

CH20 

+ 

H 

5 . OE+13 

0. 

21000. 

CH3 

+ 

CH3 

= 

C2H6 



2.4E+14 

-.4 

0. 

H 

+ 

C2H6 

= 

C2H5 

+ 

H2 

1.32E+14 

0. 

9700. 

0 

+ 

C2H6 

= 

C2H5 

+ 

OH 

1.13E+14 

0. 

7850. 

OH 

+ 

C2H6 

- 

C2H5 

+ 

H20 

8 . 7E+13 

0. 

3520. 

M 

+ 

C2H5 

= 

C2H4 

+ 

H 

1 .OE+17 

0. 

31000. 

C2H5 

+ 

02 

= 

C2H4 

+ 

HO 2 

2 . OE+12 

0. 

5000. 

H 

+ 

C2H5 

= 

C2H4 

+ 

H2 

4.8E+13 

0. 

0 . 

CH3 

+ 

CH2 


C2H4 

+ 

H 

2. OE+13 

0. 

0. 

H 

+ 

C2H4 

= 

H2 

+ 

C2H3 

1.5E+14 

0. 

10200 . 

M 

+ 

C2H4 

= 

C2H2 

+ 

H2 

2.6E+17 

0. 

79300 . 

C2H4 

+ 

OH 

= 

C2H3 

+ 

H20 

4.8E+12 

0. 

1230 . 

C2H4 

+ 

OH 

= 

CH3 

+ 

CH20 

2 .OE+12 

0. 

960. 

C2H4 

+ 

0 

= 

CH3 

+ 

HCO 

3.3E+12 

0. 

1130. 

C2H4 

+ 

0 

= 

CH20 

+ 

CH2 

2 . 5E+13 

0. 

5000 . 

M 

+ 

C2H3 

= 

C2H2 

+ 

H 

3.0E+15 

0. 

32000. 

C2H3 

+ 

02 

= 

CH20 

+ 

HCO 

3.98E+12 

0. 

-250 . 

C2H3 

+ 

H 

= 

C2H2 

+ 

H2 

6. OE+12 

0. 

0 . 

C2H3 

+ 

0 

= 

C2H20 

+ 

H 

3.3E+13 

0. 

0 . 

C2H3 

+ 

OH 

= 

C2H2 

+ 

H20 

5. OE+12 

0. 

0 . 

C2H3 

+ 

CH2 

* 

C2H2 

+ 

CH3 

3 . OE+13 

0 . 

0 . 

C2H3 

+ 

C2H 

=2 

. 0C2H2 



3 . OE+13 

0. 

0 . 

M 

+ 

C2H2 

= 

C2H 

+ 

H 

4 . 2E+16 

0. 

107000 

C2H2 

+ 

0 

= 

CH2 

+ 

CO 

1.6E+14 

. 0 

9890 . 

C2H2 

+ 

0 

= 

C2H0 

+ 

H 

4. OE+14 

0.0 

10660 . 

C2H2 

+ 

OH 

= 

C2H 

+ 

H20 

6.3E+12 

0.0 

7000 . 

C2H2 

+ 

OH 

= 

C2H20 

+ 

H 

3.2E+11 

0.0 

200 . 

C2H 

+ 

02 

= 

C2H0 

+ 

0 

5. OOE+13 

0. 

1500 . 

C2H 

+ 

OH 

= 

C2H0 

+ 

H 

2. OE+13 

0 . 

0. 

C2HO 

+ 

02 

=2, 

. OCO 

+ 

OH 

1.46E+12 

0. 

2500. 

C2HO 

+ 

0 

=2, 

. OCO 

+ 

H 

1 . 2Q2E+12 

0. 

0 . 

C2H0 

+ 

OH 

=2 , 

, OHCO 



1. OE+13 

0. 

0 . 

C2H0 

+ 

H 

= 

CH2 

+ 

CO 

5. OE+13 

0. 

0 . 

C2HO 

+ 

CH2 

= 

C2H3 

+ 

CO 

3. OE+13 

0. 

0 . 

C2HO 

+ 

CH2 

= 

CH20 

+ 

C2H 

1 .OE+13 

0. 

2000 . 


2. 

. 0C2HO 

= 

C2H2 

+2 , 

. OCO 

1. OE+13 

0 . 

0 . 

C2H20 

+ 

OH 

= 

CH20 

+ 

HCO 

2 . 8E+13 

0. 

0. 

C2H20 

+ 

OH 

= 

C2H0 

+ 

H20 

7.5E+12 

0. 

3000. 

C2H20 

+ 

H 

- 

CH3 

+ 

CO 

1.13E+13 

0. 

3428 . 

C2H20 

+ 

H 

~ 

C2H0 

+ 

H2 

7.5E+13 

0. 

8000 . 

C2H20 

+ 

0 

= 

C2H0 

+ 

OH 

5. OE+13 

0. 

8000 . 

C2H20 

+ 

0 

= 

CH20 

+ 

CO 

2. OE+13 

0. 

0. 

M 

+ 

C2H20 

= 

CH2 

+ 

CO 

2 . OE+16 

0. 

60000. 

C2H 

+ 

0 


CO 

+ 

CH 

5. OE+13 

0. 

0 . 

CH30 

+ 

02 

= 

CH20 

+ 

H02 

1. OE+13 

0. 

7170 . 

CH30 

+ 

H 

= 

CH20 

+ 

H2 

2. OE+13 

0. 

0 . 

M 

+ 

CH20 

= 

HCO 

+ 

H 

5. OE+16 

0. 

81000. 

CH20 

+ 

OH 

= 

HCO 

+ 

H20 

3 .OE+13 

0. 

1200. 

CH20 

+ 

H 

= 

HCO 

+ 

H2 

2.5E+13 

0. 

3990. 

CH20 

+ 

0 

= 

HCO 

+ 

OH 

3.5E+13 

0. 

3510. 

CH3 

+ 

CH20 

- 

CH4 

+ 

HCO 

1.0E+10 

0.5 

6000 . 

CH3 

+ 

HCO 

= 

CH4 

+ 

CO 

3.0E+11 

.5 

0 . 

CH3 

+ 

HO 2 

- 

CH30 

+ 

OH 

2 . OE+13 

0. 

0. 

M 

+ 

CH3 

= 

CH2 

+ 

H 

1.95E+16 

0. 

91600. 

H 

+ 

CH3 

= 

H2 

+ 

CH2 

2.7E+11 

.67 

25700. 

0 

+ 

CH3 

= 

OH 

+ 

CH2 

1 . 9E+11 

.68 

25700. 

OH 

+ 

CH3 

= 

H20 

+ 

CH2 

2.7E+11 

. 67 

25700. 

CH 

+ 

C02 

= 

HCO 

+ 

CO 

3 . 7E+12 

0. 

0. 

CH 

+ 

02 

= 

HCO 

+ 

0 

1 . OE+13 

0. 

0 . 

CH2 

+ 

02 

SB 

CH20 

+ 

0 

5.0E+11 

0.5 

6960. 

CH2 

+ 

0 

- 

CH 

+ 

OH 

2 . OE+11 

.7 

25800 . 

CH2 

+ 

OH 

= 

CH 

+ 

H20 

5 . OE+ll 

.5 

5900 . 

CH2 

+ 

H 

- 

CH 

+ 

H2 

3.2E+11 

0.7 

4970 . 

CH2 

+ 

CH2 

= 

C2H3 

+ 

H 

5. OE+12 

0. 

0. 



TABLE 13.1. — Continued. 


CH2 

+ 

CH2 


= 

C2H2 

+ 

HCO 

+ 

02 


= 

CO 

+ 

HCO 

+ 

0 


- 

CO 

+ 

HCO 

+ 

OH 


- 

CO 

+ 

HCO 

+ 

H 


= 

CO 

+ 

M 

+ 

HCO 


= 

H 

+ 

CO 

+ 

0 


- 

C02 

+ 

CO 

+ 

02 


= 

C02 

+ 

CO 

+ 

OH 


= 

C02 

+ 

CO 

+ 

HO 2 


= 

C02 

+ 

0 

+ 

H20 


= 

OH 

+ 

H 

+ 

02 


= 

OH 

+ 

0 

+ 

H2 


= 

OH 

+ 

H 

+ 

HO 2 


= 

H2 

+ 

0 

+ 

H02 


= 

OH 

+ 

HO 2 

+ 

OH 


= 

H20 

+ 

H 

+ 

HO 2 


=2 

. OOH 


H2 

+ 

HO 2 



H202 

+ 

OH 

+ 

H202 


= 

H20 

+ 

H02 

+ 

HO 2 


ss 

H202 

+ 

H 

+ 

H202 


= 

OH 

+ 

M 

+ 

H202 


=2 

. OOH 


THIRDBODY 






H2 

2 

. 30 

02 


. 78 


END 







H2 

+ 

OH 


= 

H20 

+ 

H 

+ 

02 



H02 

+ 

THIRDBODY 






02 

1 

.30 

N2 


1 . 3 


END 







M 

+ 

H20 


= 

H 

+ 

THIRDBODY 






H2 

4 

. 00 

02 


1.5 


C02 

4 

.0 

END 




H 

+ 

0 



OH 

+ 

M 

+ 

H2 


= 

H 

+ 

THIRDBODY 






H2 

4 

. 10 

02 


2.0 


END 







M 

+ 

02 


= 

0 

+ 

CH 

+ 

N2 


= 

HCN 

+ 

CN 

+ 

H2 


= 

HCN 

+ 

0 

+ 

HCN 


= 

OH 

+ 

OH 

+ 

HCN 


= 

HNCO 

+ 

CN 

+ 

0 


= 

CO 

+ 

CN 

+ 

OH 



NCO 

+ 

H2 

+ 

NCO 


= 

HNCO 

+ 

HNCO 

+ 

H 



NH2 

+ 

CN 

+ 

02 


= 

NCO 

+ 

CN 

+ 

C02 


= 

NCO 

+ 

0 

+ 

NCO 


= 

NO 

+ 

N 

+ 

NCO 


= 

N2 

+ 

H 

+ 

NCO 


= 

NH 

+ 

CH 

+ 

NO 


= 

N 

+ 

CH 

+ 

NO 


= 

0 

+ 

NH 

+ 

OH 


= 

N 

+ 

HO 2 

+ 

NO 


= 

N02 

+ 

0 

+ 

N02 


= 

NO 

+ 

NO 

+ 

0 


= 

NO 2 

+ 

NO 2 

+ 

H 


= 

NO 

+ 

NO 

+ 

H 


= 

N 

+ 

NO 

+ 

0 


= 

N 

+ 

0 

+ 

N2 


= 

NO 

+ 

N 

+ 

N02 


=2. 

ONO 


M 

+ 

N20 


- 

N2 

+ 

0 

+ 

N20 


- 

N2 

+ 

0 

+ 

N20 


=2. 

ONO 


N20 

+ 

H 


= 

N2 

+ 

NO 2 

+ 

H2 



HN02 

+ 

OH 

+ 

NO 2 


= 

HNO 3 

+ 

THIRDBODY 






02 

0. 

70 

H2 


1.4 


OH 

+ 

NO 


= 

HN02 

+ 

HNO 

+ 

H 


= 

H2 

+ 

H 

+ 

NO 


= 

HNO 

+ 


H2 

4 . OE+13 

0. 

0. 

H02 

3 . OE+1 3 

0. 

0. 

OH 

3. OE+13 

0. 

0. 

H20 

3. OE+13 

0. 

0. 

H2 

2. OE+13 

0. 

0. 

CO 

2.9E+14 

0. 

15570. 

M 

2.4E+15 

0. 

4100. 

0 

2 . 5E+12 

0. 

47690 . 

H 

4.17E+11 

0. 

1000. 

OH 

5.75E+13 

0. 

22930. 

OH 

6.8E+13 

0. 

18365. 

0 

1. 89E+14 

0. 

16400. 

H 

4.20E+14 

0. 

13750. 

02 

7.28E+13 

0. 

2126. 

02 

5. OE+13 

0. 

1000. 

02 

8.0E+12 


0 . 


1.34E+14 

0. 

1070. 

H 

7.91E+13 

0. 

25000. 

HO 2 

6.1E+12 

0. 

1430. 

02 

1.8E+12 

0. 

0. 

H20 

7.8E+11 

0. 

0. 


1.44E+17 

0. 

45510. 

H20 

6.0 H202 

6 . 6 

H 

4.74E+13 

0. 

6098 . 

M 

1.46E+15 

0. 

-1000. 

H20 

21.3 C02 

7.0 

OH 

1 . 30E+15 

0. 

105140 

H20 

20.0 N2 


1.5 

M 

7. 1E+18 

- 1 . 

0 . 

H 

2.2E+14 

0. 

96000 

H20 

15.0 N2 


2 . 0 

0 

1.80E+18 

- 1 . 

118020 

N 

1 . 0E+11 

0. 

19000 . 

H 

6 . OE+13 

0. 

5300 . 

CN 

1.4E+11 

, 68 

16900 . 

H 

4.0E+11 

0. 

2800 . 

N 

1.2E+13 

0. 

0. 

H 

2.5E+14 

0. 

6000. 

H 

1.0E+14 

0. 

9000. 

CO 

1.0E+14 

0. 

8500. 

0 

3.2E+13 

0. 

1000. 

CO 

3 . 7E+12 

0. 

0. 

CO 

2. OE+13 

0. 

0 . 

CO 

1. OE+13 

0. 

0. 

CO 

2. OE+13 

0. 

0. 

HCO 

1.6E+13 

0. 

9940. 

HCN 

2.0E+12 

0. 

0. 

H20 

5.0E+11 

0.5 

2000 . 

OH 

2.09E+12 

0. 

-477 . 

02 

1. OE+13 

0. 

596. 

M 

5. 62E+15 

0. 

-1160. 

OH 

3 . 47E+14 

0. 

1470. 

OH 

2 . 63E+14 

0. 

50410 . 

02 

3.8E+9 

1. 

41370 . 

N 

1.80E+14 

0. 

76250 . 


4 . OE+12 

0. 

0. 

0 

6. 92E+23 

-2 . 5 

65000. 

02 

1.0E+14 

0 . 

28020. 


6.92E+13 

0 . 

26630. 

OH 

7. 59E+13 

0 . 

15100. 

H 

2.4E+13 0 


29000. 

M 

3.0E+15 0 


-3800. 

END 

M 

5.6E+15 0 


-1700 . 

NO 

5 . 0E+12 

0 . 

0 . 

M 

5.4E+15 

0 . 

-600. 



13. Examples of Code Usage 


TABLE 13.1— Concluded. 

HNO + OH = H20 + NO 3.6E+13 0. 0. 

AR 

DISTANCE AREA CGS CGS 

&prob welstr= . true. , conc= . false . , wsf low= . true . , rxntst= . true . , 
cx0=15.0, cxl=20.0, print=0 . 4 , 2 . 0 , 4 . 0, rocket = . true . , htran= . true . , 
qmread=. false. , twall=700 . 0 , pc=73.5, athrot=2 . 325 , tend 
twsprob dotmax=1600 . 0 , delmd=800.0, mpr=l, volume=300 . 0, 
wsrhtr= . true . , wsrhtl=0.05, wsrht0=-42 . 88 , &end 
&start t=614 . 0, p=5.0, mdot=10.0, molef =. false . , x=0.2, &end 


C3H8 

0.0873262 

N2 

0.6892887 

02 

0.211232 

AR 

0.011737 

C02 

0.0004162 

END 

fcsolver 

emax=1.0E-4, atolsp=l . OE-13 , 


FINIS 


following the PSR computation and the input and output 
units. The words DISTANCE, starting in column 1, and 
AREA, starting in column 11, tell the code that an assigned- 
area calculation will be performed with distance as the inte- 
gration variable. Note that only the second field in this line 
has to contain information because distance is the integration 
variable, individual species mass fractions at the reactor inlet 
will be specified, and cgs units are used for both input and 
output. However, for illustrative purposes we have included 
the integration variable and both input and output units: the 
word CGS starting in columns 21 and 31, respectively. 

Next the problem data file contains namelist PROB, in 
which the variables WELSTR and WSFLOW are set equal to 
TRUE to indicate, respectively, that a PSR problem and a 
flow problem following it are to be solved. (Note that if 
WSFLOW = TRUE, WELSTR need not be set and has been 
included for illustrative purposes only.) The variable CONC 
is set equal to FALSE so that for the flow problem mass frac- 
tions will be printed (instead of the default molar concentra- 
tions). The variable RXNTST is set equal to TRUE, so that 
the reaction mechanism legality test will be performed. The 
area profile for the flow problem is specified by means of the 
variables CXO (= 15.0) and CXI (= 20.0), which together in- 
dicate that area is a linear function of distance. The distance 
values at which output is required are entered into the array 
PRINT. Because rocket performance parameters are re- 
quired, ROCKET is set equal to TRUE and values are sup- 
plied for the combustion chamber pressure PC (in pounds per 
square inch absolute) and the nozzle throat area ATHROT (in 
square inches). The chamber pressure will be considered 
equal to the PSR pressure, and so PC = 73.5 psia (5 atm). 
Finally HTRAN is set equal to TRUE to indicate that heat 
loss from the nozzle is to be considered. Because the built-in 
correlations are to be used for Q \ QMREAD is set equal to 
FALSE and the wall temperature is entered into TWALL. 

Because a PSR computation is required, PROB is followed 
by namelist WSPROB. The variable DELMD (= 800 g/s), 
the mass flow rate increment for successive convergences, 


tells the code that an assigned-mass-flow-rate calculation is 
to be performed. The desired mass flow rate (1600 g/s) 
through the PSR is entered into DOTMAX. The volume of 
the reactor is given by VOLUME. The variable WSRHTR is 
set equal to TRUE, indicating that the problem is not adia- 
batic and that the heat loss rate must be computed. The coef- 
ficients for the (^calculation are the variables WSRHT0 and 
WSRHT1. The value MPR = 1 tells the code that PSR 
results are to be printed after every convergence. (Although 
the default value for MPR is unity, we have included this 
variable for demonstration purposes.) 

13. 1.1. 1.3 Reactor inlet and initial conditions : Next, 
namelist START gives the reactor inlet temperature T and the 
mass flow rate MDOT for the first solution. Because the PSR 
solution is started with conditions close to the equilibrium 
state (see chapter 9, section 9.8), we assign a small value (10 
g/s) for MDOT The reactor pressure P is set because an as- 
signed-area flow problem follows the PSR problem. Because 
area was specified in PROB, START does not list any of the 
three quantities AREA, V, and MACH. The variable MOLEF 
is set equal to FALSE to indicate that the mixture composi- 
tion at the reactor inlet will be specified by means of mass 
fractions (instead of the default mole fractions). 

For reasons given in section 13.1.1 we set X = 0.20 for the 
initial value of distance for the flow problem. Finally, be- 
cause the initial reaction time for this problem is zero, TIME 
is not given. 

Namelist START is followed by the species names and 
their mass fractions at the reactor inlet. The end of the spe- 
cies list is denoted by a line containing the word END in the 
first three columns. 

13.1.1.1.4 Integration controls for flow problem: 
Namelist SOLVER follows the initial mixture composition 
and contains values for the local relative (EMAX) and abso- 
lute (ATOLSP) error tolerances for the flow problem. 

13.1.1.1.5 FINIS line : The last line contains the word 
FINIS starting in column 1 to indicate the end of the case 
data. 
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13.1 Kinetics Test Cases 


13.L1.2 Sample results . — Table 13.2 gives some of the 
computed results for the PSR problem and for the flow prob- 
lem at x = 4 cm. The PSR solution required 22 iterations and 

1.2 s of CPU time. The computational work for the flow 
problem was as follows: 158 steps, 203 derivative evalua- 
tions, 30 Jacobian matrix evaluations, and 4.2 s of CPU time. 

13.1.2 Hydrogen- Air Flow Problem and Accuracy 
of Integration Method 

When using any numerical integration procedure such as 
LSODE, the user must have an idea of the effects of the local 
error tolerance parameters on the results. The error control 
should be set tight enough to give the desired accuracy with 
the smallest amount of computational work. To examine 
how the computational work and solution accuracy are influ- 
enced by the local error tolerances, we study the ignition of a 
stoichiometric hydrogen-air mixture in supersonic flow. 

The chemical mechanism is the H-O-N reaction subset of 
the propane-air reactions used for the first example problem. 


Because the mechanism for that case was found to be legal, 
we will not ask for mechanism legality testing here. How- 
ever, we want to change temporarily the thermodynamic data 
for the hydroperoxyl radical (HO 2 ) to reflect a new value for 
its heat of formation at 298.15 K. 

A stoichiometric hydrogen-air mixture at an initial tem- 
perature of 1559 K and an initial pressure of 0.956 atm starts 
flowing (at x = 0 and t = 0) in a constant-area (2000 cm 2 ) 
duct at a Mach number of 5.0. The integration variable is 
distance and the solution is required at x = 3.048, 6.096, 
7.620, and 12.19 cm. The initial mixture composition is to be 
specified by using the simplified-composition input option. 
In particular, the equivalence ratio will be given, and the oxi- 
dant composition is the same as that built into the code. 
Also, the initial mixture will consist of only the fuel and the 
standard oxidant species (i.e., it will not contain any trace 
species). 

The flow is nonadiabatic, with heat loss rate per unit dis- 
tance Q' (in calories per second per centimeter) as a function 
of temperature, given by 


TABLE 13.2 — COMPUTED RESULTS FOR PROPANE- 
AIR, PSR-PLUS-FLOW EXAMPLE PROBLEM 


Variable 

PSR problem 

Flow problem 


(m - 1600 g/s) 

(x = 4 cm) 

Reaction time, s 

— 

2.108xl0“ 5 

Pressure, atm 

5.0 

0.311 

Velocity, m/s 


2057.4 

Temperature, K 

2148.7 

1204.1 

Density, g/cm 3 

7.361x10“* 

8.186xlO“ 5 

Specific heat, cal/g-K 

0.3661 

0.3334 

Specific heat ratio 

1.264 

1.298 

Species mass fractions 

c 3 h 8 

3.933xl0“ 5 

3.618xl0“ 7 

CH 3 

1.006xl0~ 3 

1. 442x10-* 

ch 4 

7.496x1 O' 4 

6.337x10-* 

c 2 h 4 

3.306x10“* 

2.073x10-* 

H 

1.811 x 10 - 4 

9.783x1 0 -5 

H 2 

3.674xl0“ 3 

3.877xl0 -3 

o 2 

2.705xl0“ 3 

7.138x10“* 

ho 2 

4.010XKT 6 

4.01 Ox I0 -7 

0 

9.398xl0“ 5 

4.246x1 0 -6 

OH 

1.268xl0“ 3 

4.445xl0“ 5 

h 2 ° 

0.1014 

0.1028 

ch 2 o 

7.77 2xl0 -5 

3.408x1 0 -5 

C 2 »6 

3.677xi0“ 5 

1.356x10“* 

c 2 h 2 

2.67 1 xlO" 3 

2.542xl0 -3 

CO 

0.1073 

0.1081 

c 2 ho 

8.319xl0“ 5 

2.91 3X10 -6 

co 2 

7.710xl(T 2 

7.924x1 0 -2 

h 2 o 2 

1.942x1 O’ 7 

1.464X10* 8 

n 2 

0.6892 

0.6892 

HCN 

2.937xl0“ 5 

2.977xl0“ 5 

HNCO 

6.680x1 0 -6 

2.930x1 0 -6 

nh 2 

2.934xlO“ 5 

3.1 17xl0“ 5 

NO 

1.245x10“* 

1.255x10“* 
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13. Examples of Code Usage 


Q' = -42.88 + 5.8637 (13.3) 

where T is the temperature in Kelvin. Finally, the input data 
will be given in cgs units, and output information must be 
supplied in the same units. 

13.1.2.1 Description of problem data file. — The problem 
data file for this case is shown in table 13.3. The first line of 
the file contains the word CARD in the first four columns to 
tell the code that thermodynamic data for some (or all) spe- 
cies are provided in the problem data file. The next four 
lines give the required data for HO 2 . Because this is the only 
species for which thermodynamic data are to be furnished in 
the problem data file, the next line contains the word END in 
columns 1 to 3. The title for the problem follows this infor- 
mation. 

Then we give the reaction list, which is ended by using a 
different method than that used in the previous case. The 
word END is written in columns 4 to 6 of the line following 
the last reaction. The combustion air contains small amounts 
of CO 2 and argon. Because we have chosen not to include in 
the mechanism any reaction involving C0 2 , the next line of 
the file contains the names of the two inert species CO 2 
(= C02) and Ar (= AR). For this case we use a different 
method of ending the list of inert species than in the previous 
example. Instead of leaving the third species field blank, we 
write END in its first three columns. 

The integration and assigned variables, units, and fuel 
name line contains a blank first field and the word AREA in 
the second field because we are performing an assigned-area 
flow problem with distance as the integration variable. 
Because the simplified-composition input option is being 
used, the fuel name (H2) must be given on this line, starting 
in column 41. Finally, because both input and output units 
are cgs, columns 21 to 40 are blank. 

In namelist PROB we indicate a constant-area profile by 
setting a nonzero value for only CXO (= 2000.0). The de- 
sired print stations are entered into the array PRINT. Finally 
HTRAN and QMREAD are set equal to TRUE to indicate 
that heat transfer rates are to be computed for the problem 
and that the necessary coefficients will be provided by the 
user. The two coefficients in the Q' expression, equation 
(13.3), are listed as the variables HT0 and HT1. (We have in- 
cluded QMREAD for illustrative purposes only. Its default 
value is TRUE.) 

Namelist START is next and the variables P (initial pres- 
sure), T (initial temperature), and MACH (initial Mach num- 
ber) provide the necessary initial thermodynamic and fluid 
mechanic properties. Because the initial distance and reac- 
tion time are both zero, neither TIME nor X is set. The non- 
zero value for ERATIO (= 1.0) indicates that the simplified- 
composition input option is being used by means of the fuel- 
oxidant equivalence ratio. The latter fact means that we must 
also give the nonzero stoichiometric coefficients of carbon 
(SCC), hydrogen (SCH), and oxygen (SCOX) in the fuel. 


Because the fuel is hydrogen (H 2 ), SCH is set equal to 2.0. 
(For illustrative purposes we have assigned a value of zero 
for the other two coefficients.) Because the equivalence- 
ratio option requires the (default) value of TRUE for 
MOLEF, this variable is not given. Finally, because the built- 
in oxidant composition is to be used, the variables ARAT, 
CRAT, and NOXRAT are not set. 

No individual initial mole fraction is listed after namelist 
START because the initial mixture does not contain any trace 
species. A blank line, or one containing the word END in the 
first three columns, must nevertheless follow START, as 
shown in table 13.3. 

The data file ends with namelist SOLVER and the usual 
FINIS line. Because default values are to be used for all vari- 
ables, including EMAX (= 10" 5 ) and ATOLSP (= 1(T 14 ), 
SOLVER contains only the beginning and ending of the 
namelist. 

13.1.2.2 Computed results and error considerations. — In 
order to examine the dependences of solution accuracy and 
computational work on the local error tolerances, this ex- 
ample problem was solved with various values for EMAX, 
which was progressively decreased from 10 -2 to 1CT 9 by a 
factor of 10. For this study ATOLSP was set equal to 
10 _9 EMAX. 

The effects of EMAX can be ascertained from table 13.4, 
which gives selected results at x = 6.096 cm. The computa- 
tional work, as measured by the first four quantities in this 
table, increased significantly as EMAX was decreased. 
However, the differences in the computed solutions were 
quite small. Temperature decreased by about 0.1 percent, and 
the largest change in a species mole fraction was for nitric 
oxide (NO), which decreased by about 3 percent when 
EMAX was reduced from 10“ 2 to 10~ 9 , All other mole frac- 
tions changed by less than 1 percent. Table 13.4 shows that 
the computed results become essentially tolerance indepen- 
dent at EMAX = 10~ 4 . In fact, for this problem LSODE is 
quite accurate even for EMAX = 10 -2 . However, because 
this may not always be the case, it is usually necessary to find 
the optimal EMAX for any new problem by a few trial 
computations. 

The effects of ATOLSP on solution accuracy and computa- 
tional efficiency were studied by progressively increasing 
ATOLSP from 10 -14 to 10~ 7 by a factor of 10. All results 
were generated with EMAX = 10" 5 . Selected results at 
x = 6.096 cm are presented in table 13.5. The computational 
work generally decreased when ATOLSP was increased. The 
results were relatively insensitive to ATOLSP in the range 
10“ 14 to 10 -9 . However, for ATOLSP > 10~ 8 they deviated 
from their accurate values: for ATOLSP = 

10 7 the solution was significantly inaccurate, with several 
species concentrations being less than zero. Also no heat re- 
lease had occurred and the temperature was little changed 
from its initial value. The same behavior was observed at 
x = 12.19 cm: the temperature was 1556 K, instead of 2683 K 
(the accurate value). For this ATOLSP the maximum local 
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TABLE 13.3 — PROBLEM DATA FILE FOR HYDROGEN-AIR SUPERSONIC FLOW EXAMPLE PROBLEM 


CARD 

300.000 

HO 2 

0 . 40173060E 01 
-0 . 11412445E 04 
-0. 95674952E-08 
END 


1000.000 5000.000 

J 9/78H 1.0 2. 0. 0 . G 300.000 5000.000 33.00669 

0 . 22175883E-02-0 . 57710171E-06 0 . 71372882E-10-0 . 36458591E-14 
0.37846051E 01 0.35964102E 01 0 . 52500748E-03 0 . 75118344E-05 
0.36597628E-11-0. 893335 02 E 03 0.66372671E 01 0.00000000 

L: CHAPTER 13, CASE 2 
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02 
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1.4 
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OH 
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= H2 

+ 

NO 

H 

+ 

NO 


= HNO 

+ 

M 
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OH 


= H20 
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NO 

END 







C02 

AR 


END 





AREA 





H2 

&prob 

cx0=2000 . 0 , 

print=3 . 048 , 6 . 096, 7 

. 620, 12 . 19, 

htran 

= . true 

. , qmread= 

. true . , htl= 

5.863, ht 0=-42 

&. start 

p=0 . 956, t= 

1559 

. 0 , mach=5 . 0 



eratio=l . 0 , 

scc=0 

.0, 

sch=2.0, scox=0. 

. 0 , &end 


6.8E+13 

0. 

18365. 

1 . 89E+14 

0. 

16400. 

4.20E+14 

0. 

13750. 

7 . 28E+13 

0. 

2126. 

5 . OE+13 

0. 

1000. 

8 . OE+12 

0. 

0. 

1 . 34E+14 

0. 

1070. 

7 . 91E+13 

0. 

25000 . 

6.1E+12 

0. 

1430. 

1 . 8E+12 

0. 

0. 

7 . 8E+11 

0. 

0. 

1 .44E + 17 

0. 

45510. 

6 . 0 H202 

6.6 

4.74E+13 

0. 

6098 . 

1.46E+15 

0. 

-1000. 

21.3 H2 


3.0 

1.30E+15 

0. 

105140 

20.0 N2 


1.5 

7 . 1E+18 

-1 . 

0. 

2 . 2E+14 
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96000 

15.0 N2 
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-1 . 

118020 

2 . 09E+12 

0. 

-477 . 

1. 0E+13 

0. 

596. 

5. 62E+15 

0. 

-1160 . 

3 . 47E+14 
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1470. 

3 . 8E+9 

1. 

41370. 

1 . 8E+14 

0. 

76250 . 

2 . 63E+14 

0. 

50410 . 

6 . 92E+23 

-2.5 

65000 . 

1. OE+14 

0. 

28020 . 

6. 92E+13 

0. 

26630 . 

4 . OE+12 

0. 

0 . 

7 . 59E+13 

0 . 

15100 . 

2.4E+13 0 


29000. 

3.0E+15 0 


-3800 . 

5.6E+15 0 


-1700 . 

5. OE+12 

0 . 

0 . 

5.4E+15 

0 . 

-600. 

3 . 6E+13 

0 . 

0 . 


&end 


END 


&solver &end 
FINIS 
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13. Examples of Code Usage 

error in a species mole fraction is only about 2 ppm. These 
results demonstrate the importance of being conservative in 
selecting ATOLSP. Table 13.5 shows that the optimal 
ATOLSP is 10 -12 ; note that it required less computational 
work than 10 -n despite being more accurate. The value of 
10” 12 may be peculiar to this case, and so in general a trial- 
and-error optimization procedure for ATOLSP is necessary. 

13.2 Sensitivity Test Case: Constant- 
Volume, Adiabatic, Static Benzene- 
Oxygen-Argon Combustion 
Reaction 

The last example problem concerns kinetics and sensitivity 
analysis calculations in a constant-volume, adiabatic, static 
system. The problem describes the ignition and subsequent 
combustion of a near-stoichiometric ((p = 1 .007) benzene- 
oxygen-argon mixture (with 85.728 percent argon in the mix- 
ture). The initial temperature and pressure are 1405 K and 
2.3868 atm, respectively. The reaction mechanism contains 
40 species and 120 reactions, and so reaction mechanism le- 
gality testing will be required. Thermodynamic data for all 
species are to be taken from the standard thermodynamic 
data file. For both input and output cgs units are to be used. 
We will specify the initial mixture composition by means of 
species mole fractions. 

Sensitivity coefficients are required for the 14 dependent 
variables <Jc 6 h 6 > Goth GQyHy g Hv o<> a H2 o> Gco> tfc 2 H 2 > 
a C 6 H 5 OH> OCsHtf’ a C o 2 > ^ anc * P w * th res P ect to ^ ree rate 
coefficient parameters of the seven reactions listed in 
table 13,6. Here is the mole number of species i. Sensitiv- 
ity coefficients with respect to the initial values of the six 
variables Oc 6 h 6 > a OH> a H 2 0> a Ar> T, and p must also be com- 
puted. The solution is required at the five output stations 
10 6 , 10 5 , 6x10 5 , 2. 8xl0 -4 , and 3xl0~ 4 s (initial time = 
0). The standard format is to be used for printing the sensi- 


TABLE 13.6.— REACTIONS FOR WHICH 
SENSITIVITY ANALYSIS IS REQUIRED 
FOR BENZENE-OXYGEN-ARGON 
EXAMPLE PROBLEM 


Reaction 

number, 

i 

Reaction 

1 

+ 0 2 - C 5 H 5 0 + OH 

6 

CgHg + OH - C 6 H 5 + H 2 0 

8 

c 6 h 5 o - C 5 H 5 + CO 

12 

C 6 H 5 OH - C 6 H s O + H 

17 

C 5 H 6 + 0 2’* C 5 H 5 0 + 0H 

18 

c 6 h 5 oh + OH - c 6 h 5 o + h 2 o 

104 

H + 0 2 - OH + O 


tivity coefficients with respect to the rate coefficient param- 
eters. Finally any normalized sensitivity coefficient with 
magnitude less than 10 ^ is to be set equal to zero. 

13.2.1 Description of Problem Data File 

The required problem data file for this case is listed in 
table 13.7 and described here. 

13.2.1 .1 Thermodynamic data , title line , and reaction 
mechanism data . — The first line of the problem data file 
contains the word TAPE in columns 1 to 4 because all ther- 
modynamic data are to be taken from the standard thermody- 
namic data file. The second line contains the case title. It is 
followed by the chemical mechanism, which was taken from 
reference 40. The blank line after the last reaction denotes 
the end of the reaction list. It is followed by a line with the 
name (AR) of the inert species argon in columns 1 and 2. 
The blank species field in columns 11 to 18 designates the 
end of the inert species list. 

13.2.1.2 Problem setup data. — The next line contains the 
word TIME starting in column 1. This is the integration vari- 
able for a constant-volume (or any) static reaction problem. 
The remainder of the line is blank because there is no as- 
signed variable; (the default) cgs units are used for both input 
and output; and the simplified-composition input option is 
not used. 

Namelist PROB, which is placed next, contains the follow- 
ing variables: The array PRINT lists the print stations (in 
seconds) at which output is required. The variable RXNTST 
is set equal to TRUE because the legality of the reaction 
mechanism is to be tested. The variables RHOCON and 
SENCAL are set equal to TRUE because this is a constant- 
volume (density) problem and sensitivity analysis computa- 
tions are required. Finally TINY is set equal to 1 .Ox 10“ 7 so 
that any normalized sensitivity coefficient with magnitude 
less than this value will be set equal to zero. 

13.2.1.3 Initial conditions and integration controls . — In 
namelist START, which follows PROB, we give initial values 
for only the temperature T and pressure P because the test 
case involves a constant-density calculation. Because the ini- 
tial reaction time is zero, TIME is not set. Following this 
namelist the species names and their initial mole fractions 
(because MOLEF is not set equal to FALSE in START) are 
given. The blank line indicates the end of the list of initial 
mole fractions. Next, namelist SOLVER gives EMAX and 
ATOLSP. 

13.2.1.4 Sensitivity analysis data . — All three data types 
that may be given for sensitivity analysis computations are 
listed. The first keyword designating data type is SENSVAR, 
which indicates that the dependent variables whose sensitiv- 
ity coefficients are required will be given on the following 
line (or lines). Fourteen variables are listed: eight on the first 
line and six on the second. They include the names of the 12 
species, temperature, and pressure. The dependent variable 
list is concluded by the word END in the variable field fol- 
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TABLE 13.7 — PROBLEM DATA RLE FOR BENZENE-OXYGEN-ARGON SENSOTVITY EXAMPLE PROBLEM 
TAPE 


BENZENE -02 -ARGON SHOCK IGNITION SENSITIVITY TEST CASE: CHAPTER 13, CASE 3 


C6H6 

+ 

02 

= C6HSO 

+ 

OH 

4 . OE+13 

0. 

34000 . 

C6H6 

+ 

C6H5 

= C12H10 

+ 

H 

4 . OE+11 

0. 

4000 . 



C6H6 

= C6H5 

+ 

H 

1. OE+16 

0 . 

108000 

C6H6 

+ 

H 

= C6H5 

+ 

H2 

2.5E+14 

0. 

16000 . 

C6H6 

+ 

0 

= C6H50 

+ 

H 

2 .7 83E+13 

0 . 

4910. 

C6H6 

+ 

OH 

= C6H5 

+ 

H20 

2 . 132E+13 

0. 

4580. 

M 

+ 

C4H3 

= C4H2 

+ 

H 

l.OE+16 

0.0 

60000 . 



C6H50 

= C5H5 

+ 

CO 

2 . 51E+11 

0. 

43900 . 

C6H5 

+ 

02 

= C6H50 

+ 

O 

2.1E+12 

0. 

7470 . 

C6H5 

+ 

HO 2 

= C6H50 

+ 

OH 

2 .OE+13 

0. 

1000 . 



C6H5 

= C4H3 

+ 

C2H2 

4 . 50E+13 

0. 

72530 . 



C6H50H 

= C6H50 

+ 

H 

2 . 00E+16 

0 . 

88000 . 

C6H50H 

+ 

H 

= C6H6 

+ 

OH 

2 . 2 OE+13 

0. 

7910 . 

C6H50H 

+ 

H 

= C6H50 

+ 

H2 

1 .15E+14 

0. 

12405 . 

C5H5 

+ 

C6H50H 

= C6H50 

+ 

C5H6 

2 . 67 E+14 

0. 

25227 . 



C5H6 

= C5H5 

+ 

H 

8 . 13E+24 

-2.981 

78682 . 

C5H6 

+ 

02 

= C5H50 

+ 

OH 

1 . OE+13 

0 . 

20712 . 

C6H50H 

+ 

OH 

= C6H50 

+ 

H20 

3 . OE+13 

0 . 

0 . 

C6H50H 

+ 

H02 

= C6H50 

+ 

H202 

3 . OE+13 

0 . 

1500 . 



C5H50 

= C4H5 

+ 

CO 

3 . OE+16 

0 . 

15000 . 

C5H5 

+ 

O 

= C5H50 



1. OE+13 

0 . 

0 . 

C5H5 

+ 

OH 

= C5H40H 

+ 

H 

1 . OE+13 

0 . 

0 . 



C5H40H 

= C4H4 

+ 

HCO 

1. OE+15 

0 . 

22000 . 

C5H5 

+ 

H02 

= C5H50 

+ 

OH 

2 . OE+13 

0 . 

0 . 


2 

. 0C6H5 

= C12H10 



3 . 1E+12 

0 . 

0 . 



C4H5 

= C2H3 

+ 

C2H2 

1.4E+13 

0 . 

32900 . 

C4H2 

+ 

0 

= C2H0 

+ 

C2H 

1 . OE+13 

0 . 

0 . 

C4H2 

+ 

OH 

= HCO 

+ 

C3H2 

3 . OE+13 

0 . 

0 . 

C4H2 

+ 

0 

= CO 

+ 

C3H2 

1 . 2E+12 

0 . 

0 . 

M 

+ 

C2H4 

= C2H2 

+ 

H2 

9.33 E+16 

0. 

77200 . 

C2H4 

+ 

OH 

= C2H3 

+ 

H20 

4 . 7 86E+12 

0. 

1230 . 

C2H4 

+ 

0 

= CH3 

+ 

HCO 

3 . 3 11E+12 

0. 

1130 . 

C2H4 

+ 

O 

= CH20 

+ 

CH2 

2 . 512E+13 

0. 

5000 . 

C2H4 

4- 

OH 

= CH3 

+ 

CH20 

1 . 995E+12 

0. 

960 . 

M 

+ 

C2H3 

= C2H2 

+ 

H 

3 . OE+15 

0 . 

32000 . 

C2H3 

+ 

02 

= CH20 

+ 

HCO 

3 . 98E+12 

0. 

-250 . 

C2H3 

+ 

H 

= C2H2 

+ 

H2 

6 . OE+12 

0 . 

0 . 

C2H3 

+ 

OH 

= C2H2 

+ 

H20 

5 . 012E+12 

0 . 

0 . 

C2H3 

+ 

CH2 

= C2H2 

+ 

CH3 

3 . 020E+13 

0. 

0 . 

C2H3 

+ 

C2H 

=2 . 0C2H2 



3 . 020E+13 

0 . 

0 . 

C2H3 

+ 

0 

= C2H20 

+ 

H 

3.3E+13 

0 . 

0 . 

CH2 

+ 

CH2 

= C2H2 

+ 

H2 

4 . OE+13 

0 . 

0 . 

CH2 

+ 

CH2 

= C2H3 

+ 

H 

5 . 012E+12 

0 . 

0 . 

CH2 

+ 

OH 

= CH 

+ 

H20 

2 . 51E+11 

.67 

25700 . 

CH2 

+ 

0 

= CH 

+ 

OH 

2 . OE+ll 

.68 

25000 . 

CH2 

+ 

02 

= CO 2 

+ 2 , 

.OH 

1 -59E+12 

0 . 

1000 . 

M 

+ 

C2H2 

= C2H 

+ 

H 

4 . 16 9E+16 

0 . 

107000 . 

C2H2 

+ 

C2H2 

= C4H3 

+ 

H 

2 . 0E+12 

0 . 

45900 . 

C2H2 

+ 

0 

= CH2 

+ 

CO 

1 .6E+14 

0 . 0 

9890 . 

C2H2 

+ 

O 

“ C2HO 

+ 

H 

4 . OE+14 

0.0 

10660 . 

C2H2 

+ 

OH 

= C2H 

+ 

H20 

6 . 310E+12 

0 . 

7 000 . 

C2H2 

+ 

OH 

= C2H20 

+ 

H 

3 . 2 E+ 11 

0 . 

200 . 

C2H2 

+ 

C2H 

= C4H2 


H 

3 .OE+13 

0 . 

0 . 

C2H2 

+ 

CH2 

= C3H3 

+ 

H 

1 . 2E+13 

0 . 

6600 . 

M 

+ 

C3H4 

= C3H3 

+ 

H 

2 . OE+17 

0 . 

65000 . 

C2H20 

+ 

OH 

= CH20 

+ 

HCO 

2 . 8E+13 

0 . 

0 . 

C2H20 

+ 

OH 

= C2H0 

+ 

H20 

7 . 5E+12 

0 . 

3000 . 

C2H20 


H 

= CH3 

+ 

CO 

1 . 13E+13 

0 . 

3428 . 

C2H20 

+ 

H 

= C2H0 

+ 

H2 

7 . 5E+13 

0 . 

8000 . 

C2H20 

+ 

O 

= C2H0 

+ 

OH 

5 . OE+13 

0. 

8000. 

C2H20 

+ 

O 

= CH20 

+ 

CO 

2 . OE+13 

0 . 

0 . 

M 

+ 

C2H20 

= CH2 

+ 

CO 

2 . OE+16 

0 . 

60000 . 

C2HO 

+■ 

02 

=2 . OCO 

+ 

OH 

1 .46E+12 

0 . 

2500 . 

C2H0 

+ 

0 

-2 . OCO 

+ 

H 

1 . 202E+12 

0 . 

0 . 

C2H0 

+ 

OH 

—2 . OH CO 



1 . OE+13 

0 . 

0 . 

C2H0 

+ 

H 

= CH2 

+ 

CO 

5 . OE+13 

0 . 

0 . 

C2H0 

+ 

CH2 

= C2H3 


CO 

3 . OE+13 

0 . 

0 . 

C2H0 

+ 

CH2 

= CH20 

+ 

C2H 

1 .OE+13 

0. 

2000 . 


2 . 

, OC2HO 

= C2H2 

+ 2 . 

. OCO 

1 . OE+13 

0 . 

0 . 

C2H 

+ 

OH 

= C2H0 

+ 

H 

2 . OE+13 

0 . 

0 . 

C2H 

+ 

02 

= C2HO 

+ 

O 

5 . 0 OE+1 3 

0 . 

1500 . 

C2H 

+ 

0 

= CO 

+ 

CH 

5 . 012E+13 

0 . 

0 . 

M 

+ 

CH4 

= CH3 

+ 

H 

2 . OE+17 

0 . 

88000 . 

CH4 

+ 

02 

= CH3 

+ 

H02 

7 .943E+13 

0 . 

56000 . 

CH4 

+ 

H 

= CH3 

+■ 

H2 

1 .26E+14 

0 . 

11900 . 
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TABLE 13.7. — Concluded. 


OH 

+ 

CH4 


= 

CH3 

+ 

O 

+ 

CH4 


- 

CH3 

+ 

CH3 

+ 

02 


- 

CH30 

+ 

CH3 

+ 

OH 


= 

CH30 

+ 

M 

+ 

CH30 


- 

CH20 

+ 

CH30 

+ 

02 


= 

CH20 

+ 

CH30 

+ 

H 


= 

CH20 

+ 

CH3 

+ 

CH3 


= 

C2H4 

+ 

CH3 

+ 

O 


= 

CH20 

+ 

CH3 

+ 

CH20 


= 

CH4 

+ 

CH3 

+ 

HCO 


= 

CH4 

+ 

CH3 

+ 

H02 


= 

CH30 

+ 

M 

+ 

CH20 


= 

HCO 

+ 

CH20 

+ 

OH 


= 

HCO 


CH 20 

+ 

H 



HCO 

+ 

CH20 

+ 

0 


= 

HCO 

+ 

HCO 

+ 

H02 


= 

CH20 

+ 

M 

+ 

HCO 


= 

H 

+ 

HCO 

+ 

02 


= 

CO 

+ 

HCO 

+ 

OH 


= 

CO 

+ 

HCO 

+ 

H 


= 

CO 

+ 

HCO 

+ 

0 


= 

CO 

+ 

CH 

+ 

02 


= 

HCO 

+ 

CO 

+ 

O 


= 

CO 2 

+ 

CO 

+ 

02 


= 

CO 2 

+ 

CO 

+ 

OH 


= 

CO 2 

+ 

CO 

+ 

H02 


= 

CO 2 

+ 

O 

+ 

H20 


= 

OH 

+ 

H 

+ 

02 


= 

OH 

+ 

o 

+ 

H2 


= 

OH 

+ 

H 

+ 

H02 



H2 

+ 

0 

+ 

H02 


= 

OH 

+ 

H02 

+ 

OH 


= 

H20 

+ 

H 

+ 

H02 


=2 . 

. OOH 


H2 

+ 

H02 


= 

H202 

+ 

OH 

+ 

H202 


m 

H20 

+ 

H02 

+ 

H02 


= 

H202 

+ 

H 

+ 

H202 


= 

OH 

+ 

M 

+ 

H202 


= 

OH 

+ 

THIRDBODY 






H2 

2 . 

30 

02 


.78 


END 







H2 

+ 

OH 


= 

H20 

+ 

H 

+ 

02 


= 

H02 

+ 

THIRDBODY 






02 

1 . 

30 

C02 


7 . 0 


C6H6 

20.0 

CH4 


5 . 0 


M 

+ 

H20 


= 

H 

+ 

THIRDBODY 






H2 

4 . 

00 

02 


1 . 5 


CO 2 

4 . 

00 

END 




H 

+ 

o 


= 

OH 

+ 

M 

+ 

H2 


= 

H 

+ 

THIRDBODY 






H2 

4 . 

10 

02 


2 . 0 


M 

+ 

02 


= 

0 

+ 


AR 

TIME 

&prob r hoc on= . true . , sencal= . true . 


print=l . OE-6 , 1 . OE- 5, 6 . OE-5, 2 . 8E-4 * 
&start t=14 05 . 0 , p=2.3868 / &end 


C6H6 

0 . 01690 



02 

0 . 12582 



AR 

0 . 85728 



&sol ver 

emax=l . OE 

-6, atolsp=l . OE- 15 , 

SENS VAR 
C6H6 

OH 

C6H5 

H 

C2H2 

C6H50H 

C5H6 

CO 2 

INIT 

C6H6 

REAC 

OH 

H20 

AR 

&senrxn 

sensaj = . true . , 

sensnj = . true . , 

rxnum= 

=1.0,6 .0, 8. 

0,12. 

0, 17 .0,18.0, 104 


FINIS 


H20 


2 . 5E+13 

0 . 

5010. 

OH 


1 .9E+14 

0 . 

11720 . 

0 


4 .7 86E+13 

0. 

29000 . 

H 


6 . 3E+12 

0 . 

0. 

H 


5.0E+13 

0 . 

21000. 

H02 


1.0E+12 

0. 

6000. 

H2 


2 . OE+13 

0. 

0. 

H2 


1 .OE+16 

0 . 

32000 . 

H 


1 .288E+14 

0. 

2000 . 

HCO 


1.0E+10 

0.5 

6000 . 

CO 


3 . 02 OE+11 

. 5 

0. 

OH 


2 . 00E+13 

0 . 

0 . 

H 


5. OE+16 

0 . 

81000. 

H20 


3 . OE+13 

0 . 

1200 . 

H2 


2 . 5E+13 

0 . 

3990. 

OH 


3.5E+13 

0. 

3510 . 

02 


1.0E+14 

0. 

3000 . 

CO 


2 . 94E+14 

0. 

15569 . 

H02 


3 . 311E+12 

0. 

7000 . 

H20 


1.0E+14 

0 . 

0. 

H2 


1 .995E+14 

0. 

0 . 

OH 


1.0E+14 

0. 

0 . 

O 


1. OE+13 

0. 

0. 

M 


5 . 9E+15 

0 . 

4100. 

0 


2 . 5E+12 

0 . 

47690 . 

H 


4 . 17E+11 

0 . 

1000 . 

OH 


5.75E+13 

0 . 

22930 . 

OH 


6 . 8E+13 

0 . 

18365 . 

O 


1 . 89E+14 

0 . 

16400 . 

H 


4.20E+14 

0 . 

13750. 

02 


7 . 28E+13 

0 . 

2126 . 

02 


5 .OE+13 

0 . 

1000 . 

02 


8.0E+12 


0 . 



1 .34E+14 

0 . 

107 0 . 

H 


7 . 91E + 13 

0 . 

25000. 

HO 2 


6.1E+12 

0 . 

1430 . 

02 


1 . 8E+12 

0 . 

0 . 

H20 


7 . 8E+11 

0 . 

0 . 

OH 


1 .44E+17 

0 . 

45510. 

H20 


6.0 H202 

6.6 

H 


4 . 7 4E+1 3 

0 . 

6098 . 

M 


1 .46E+15 

0 . 

-1000 . 

H20 


21.3 H2 


3 . 0 

END 





OH 


1.30E+15 

0 . 

105140 

H20 


20.0 C6H6 

20 . 0 

M 


7 . 1E+1 8 

-1 . 

0 . 

H 


2 . 2E+14 

0 . 

96000 

H20 


15 . 0 END 


O 


1 . 80E+18 

-1 . 

118020 

tiny=l , 

. 0E-7 , 

rxntst= . true . , 


. 0E-4, 

tend 





&end 




H2 

O 

H20 

CO 

TEMP 

PRESSURE 

END 


TEMP 

DENSITY 

END 



sense j=. true . , 
. 0 , &end 



lowing PRESSURE. (Note that if an exact multiple of eight 
variables had been listed, an additional line that either is 
blank or contains the word END starting in column 1 would 
have been required.) 

The next keyword is INTT, which signifies that sensitivities 
with respect to the initial values of certain variables must be 
computed. These variables are given on the next line, using 
the same format as that used for the dependent variables. 

The last keyword is REAC, which means that sensitivity 
coefficients with respect to rate coefficient parameters are 
required. The keyword is followed by namelist SENRXN, 
which gives the necessary information about the rate coeffi- 
cient parameters and reactions to be considered. The vari- 
ables SENSAJ, SENSNJ, and SENSEJ are set equal to TRUE 
because sensitivity coefficients with respect to the 
preexponential factor Aj , the temperature exponent n p and the 
activation energy Ej are needed. The array RXNUM contains 
the reaction numbers for which sensitivity coefficients must 
be produced. Because these coefficients do not have to be 
computed for all reactions, ALLRXN is not employed. 
Finally neither OUTPUT nor ORDER is set because (1) the 
standard format is to be used for printing the normalized sen- 
sitivity coefficients with respect to the rate coefficient param- 
eters and (2) reaction numbers do not have to be listed in 
order of decreasing importance. 

73.2.7.5 FINIS line . — The last line contains the word 
FINIS starting in column 1 to signal the end of the problem 
data file. 

13.2.2 Computed Results and Effects of 
Local Error Tolerances 

Selection of the appropriate local error tolerance param- 
eters is especially important for sensitivity analysis computa- 
tions because the accuracy of the sensitivity coefficients is 
controlled by the accuracy of the kinetics solution. In order 
to understand how the computed results vary with the local 
error tolerances, EMAX was progressively decreased from 
10 -2 to 10 - 10 by a factor of 10, while keeping ATOLSP = 
10 _9 EMAX. Table 13.8 shows the effects of EMAX on 
several species molar concentrations, temperature, pressure, 
and the computational work for the combined kinetics and 
sensitivity analysis computations. The kinetics solution was 
quite inaccurate at EMAX = 10 -2 and did not stabilize until 
EMAX was decreased to 10 -6 . This behavior is different 
from that observed previously for the hydrogen-air case (see 
table 13.4) and illustrates the need to be conservative in 
selecting EMAX. However, table 13.8 shows a strong depen- 
dence of the execution time on EMAX, which must therefore 
be optimized to minimize computational cost. 

The effects of ATOLSP on the accuracy of the solutions 
were studied by progressively increasing ATOLSP from 
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10~ 15 to 10 -8 with EMAX = 10 -6 . The kinetics results are 
given in table 13.9. Again the execution time includes that 
required for sensitivity analysis. Table 13.9 shows that 
ATOLSP has to be increased to 10“ 8 before any appreciable 
differences from the accurate values are noted in the results. 
Note that even ATOLSP = 10 -9 is sufficiently accurate. It 
was also significantly less expensive than ATOLSP = 10 -15 . 
Table 13.9 reinforces the desirability of optimizing ATOLSP. 

The effects of EMAX on the normalized sensitivity coeffi- 
cients {(5^)} with respect to the initial condition values are 
presented in tables 13.10 to 13.15. In these tables Yj is the 
tth dependent variable and G ; -,o is the initial value of Gj. The 
first four tables give the {(£;/)} with respect to the initial 
mole numbers of benzene, hydroxyl radical, water, and 
argon. Tables 13.14 and 13.15 list the normalized sensitivity 
coefficients with respect to the initial temperature and den- 
sity, respectively. The six tables show that the {(5^)} have a 
much stronger dependence than the kinetics solution on 
EMAX . They change substantially as EMAX is reduced 
from 10 -2 to 10 -5 and stabilize to three significant figures at 
EMAX = 10 -6 . The latter fact is not surprising inasmuch as 
the kinetics solution required EMAX = 10~ 6 to become 
essentially tolerance independent. 

Tables 13.16 to 13.24 show the variations of several rate 
coefficient parameter sensitivity coefficients with EMAX. 
The first seven tables give {(5; ; )} with respect to the [Aj). 
Tables 13.23 and 13.24 present the effects of varying EMAX 
on the normalized sensitivity coefficients with respect to rcg 
and £g, respectively. All { (Sy ) } stabilized to three significant 
figures only when EMAX was reduced to 10 -6 , similar to 
the initial condition sensitivities. EMAX should therefore be 
approximately 10 -6 for accurate sensitivity analysis compu- 
tations for this typical ignition and combustion problem. 

The variations of the {(Sjj)} with ATOLSP are shown in 
tables 13.25 to 13.30 for several parameters. The first three 
tables give normalized sensitivity coefficients with respect to 
the initial mole numbers of benzene and water and the initial 
temperature. Tables 13.28 to 13.30 present {(Sy)} with 
respect to A], «g, and £g, respectively. These tables show 
that varying ATOLSP in the range 10 -1 ^ to 10“ 10 has a 
small effect on the solutions. In all cases the change is a frac- 
tion of 1 percent. Although somewhat less accurate, the 
results obtained with ATOLSP = 10 -9 were adequate. The 
run with ATOLSP = 10~ 8 , especially the sensitivities of 
OCbHy did, however, incur errors greater than 10 percent. 
Again the sensitivity coefficients display similar dependence 
on the local error tolerance as the kinetics solution. Thus the 
need to generate reliable kinetics results is indicated. It is 
therefore recommended that first optimal EMAX and 
ATOLSP values be established for the kinetics solution and 
then sensitivities be generated with somewhat more accurate 
tolerances. 
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TABLE 13.10. — VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT (dY/dc c H „> WITH 
EMAX FOR BENZENE-OXYGEN-ARGON EXAMPLE PROBLEM 6 6 ' 
[ATOLSP = 10' 9 EMAX, / = 300 ms.] 


Variable 

EMAX 


i<r 2 

10‘ 3 

10- 4 

10~ 5 

10 -6 

I0" 7 

10' 8 

10~ 9 

,0-1° 





(diyac^ 

o) 




T 

2.31 

1.76 

1.70 

1.69 

1.69 

1.69 

1.69 

1.69 

1.69 

P 

2.60 

1.97 

1.90 

1.88 

1.88 

1.88 

1.88 

1.88 

1.88 

° C 6 H 6 

-20.9 

-13.4 

-12.8 

-12.6 

-12.6 

-12.6 

-12.6 

-12.6 

-12.6 

°OH 

37.3 

29.5 

28.5 

28.3 

28.3 

28.3 

28.3 

28.3 

28.3 

°C,H , 

-0.916 

3.79 

4.01 

4.07 

4.07 

4.07 

4.07 

4.07 

4.07 

o 5 

35.8 

28.4 

27.5 

27.3 

27.3 

27.3 

27.3 

27.3 

27.3 


10.3 

8.00 

7.80 

7.75 

7.74 

7.74 

7.74 

7.74 

7.74 

a 0 2 

39.0 

30.2 

29.1 

28.9 

28.9 

28.9 

28.9 

28.9 

28.9 

°h 2 ° 

8.22 

6.81 

6.63 

6.59 

6.59 

6.59 

6.59 

6.59 

6.59 

°co 

8.30 

6.66 

6.48 

6.44 

6.43 

6.43 

6.43 

6.43 

6.43 

°C,H~ 

-13.3 

-8.46 

-8.00 

-7.88 

-7.87 

-7.87 

-7.87 

-7,87 

-7.87 

i i 

a Cz-H*OH 

-17.3 

-10.1 

-9.55 

-9.40 

-9.39 

-9.39 

-9.39 

-9.39 

-9.39 

° C 5 H 6 

-14.2 

-6.97 

-6.40 

-6.26 

-6.25 

-6.25 

-6.25 

-6.25 

-6.25 

J o 

a C0 2 

19.3 

14.6 

14.1 

14.0 

14.0 

14.0 

14.0 

14.0 

14.0 


TABLE 13.1 1 —VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT <dT/3o 0H q) WITH EMAX FOR 
BENZENE-OXYGEN-ARGON EXAMPLE PROBLEM 
[ATOLSP = 10" 9 EMAX, / = 300 ms.] 


Variable 

EMAX 


10~ 2 

10" 3 

10^ 

10" 5 

KT 6 

10” 7 

1(T 8 

KT 9 

10' 10 


(5y/3o OHO ) 

T 

0.322 

0.248 

0.240 

0.238 

0.238 

0.238 

0.238 

0.238 

0.238 

P 

0.358 

0.274 

0.264 

0.262 

0.262 

0.262 

0.262 

0.262 

0.262 

°C 6 fL > 

-3.28 

-2.22 

-2.13 

-2.11 

-2.11 

-2.11 

-2.11 

-2.11 

-2.11 

°OH 

5.31 

4.28 

4.15 

4.12 

4.12 

4.12 

4.12 

4.12 

4.12 

C CAi < 

-0.371 

0.321 

0.355 

0.364 

0.364 

0.364 

0.364 

0.364 

0.364 

0 3 

C H 

4.96 

3.98 

3.86 

3.83 

3.83 

3.83 

3.83 

3.83 

3.83 

°h 2 

1.22 

0.918 

0.889 

0.883 

0.882 

0.882 

0.882 

0.882 

0.882 

«o 2 

5.61 

4.43 

4.28 

4.24 

4.24 

4.24 

4.24 

4.24 

4.24 

° H 2° 

1.10 

0.918 

0.893 

0.887 

0.887 

0.887 

0.887 

0.887 

0.887 

°CO 

1.10 

0.886 

0.860 

0.854 

0.854 

0.854 

0.854 

0.854 

0.854 

° C 2 H 2 

-2.13 

-1.44 

-1.37 

-1.36 

-1.36 

-1.36 

-1.36 

-1.36 

-1.36 

°c 6 h 5 oh 

-2.62 

-1.61 

-1.53 

-1.51 

-1.51 

-1.51 

-1.51 

-1.51 

-1.51 

°C<H. 

-2.21 

-1.19 

-1.10 

-1.08 

-1.08 

-1.08 

-1.08 

-1.08 

-1.08 

Q 

8 *- 
M C 

2.72 

2.10 

2.02 

2.01 

2.00 

2.00 

2.00 

2.00 

2.00 





[ Sri 00£ = j ‘XVW3 fi _0I = dSTIOXV] 
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TABLE 13.13.— VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT {dY/da^o) WITH EMAX 
FOR BENZENE-OXYGEN- ARGON EXAMPLE PROBLEM 
[ATOLSP = HT’EMAX, t = 300 ms.] 


Variable 

EMAX 


10" 2 

10‘ 3 

io- 4 

10' 5 

KT 6 

10- 7 

10' 8 

10" 9 

I0-'° 


QYflOto# 

T 

-3.26 

-2.49 

-2.40 

-2.38 

-2.38 

-2.38 

-2.38 

-2.38 

-2.38 

P 

-2.77 

-1.89 

-1.80 

-1.78 

-1.77 

-1.77 

-1.77 

-1.77 

-1.77 

° C 6«6 

°OH 

32.1 

21.4 

20.4 

20.2 

20.2 

20.2 

20.2 

20.2 

20.2 

-53.3 

-42.4 

-41.1 

-40.8 

-40.8 

-40.8 

-40.8 

-40.8 

-40.8 

° C 6 H 5 

3.12 

-49.9 

-3.72 

-39.6 

-4.04 

-38.4 

-4.13 

-38.1 

-4.13 

-38.1 

-4.14 

-38.1 

-4.14 

-38.1 

-4.14 

-38.1 

-4.14 

-38.1 

Ou 

-12.3 

-9.08 

-8.79 

-8.72 

-8.71 

-8.71 

-8.71 

-8.71 

-8.71 

2 

°o 

-56.4 

-44.0 

-42.5 

-42.2 

-42.2 

-42.2 

-42.2 

-42.2 

—42.2 

°h 2 ° 

-10.7 

-8.67 

-8.42 

-8.36 

-8.36 

-8.36 

-8.36 

-8.36 

-8.36 

°co 

-10.7 

-8.43 

-8.18 

-8.12 

-8.11 

—8. 1 1 

-8.11 

-8.11 

-8.11 

° c 2 H 2 

21.2 

14.2 

13.6 

13.4 

13.4 

13.4 

13.4 

13.4 

13.4 

26.0 

15.8 

15.0 

14.8 

14.7 

14.7 

14.7 

14.7 

14.7 

O 3 

° C 5 H 6 

°co 2 

22.1 

11.7 

10.9 

10.7 

10.7 

10.7 

10.7 

10.7 

10.7 

-26.6 

-20.0 

-19.3 

-19.1 

-19.1 

-19.1 

-19.1 

-19.1 

-19.1 


TABLE 13.14 — VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT {dYfiTf) WITH EMAX 
FOR BENZENE-OXYGEN-ARGON EXAMPLE PROBLEM 
[ATOLSP = 10" 9 EMAX, t = 300 |is.] 


Variable 

EMAX 

10" 2 

10~ 3 

10 -4 

10“ 5 

KT 6 

10" 7 

10 -8 

10- 9 

,0-10 

(dYfiTf) 

T 

P 

Cc 6 H 6 

°OH 

° c 6«5 

Oh 

«„ 2 

°o 

°h 2 o 

c co 

°c 2 h 2 

°c 6 h 5 oh 

° C 5 H 6 

a co 2 

96.6 

107 

-981 

1.59xl0 3 

-110 

1.49xl0 3 

366 

1.68xl0 3 

329 

330 
-639 
-784 
-662 
814 

74.0 

81.5 

-660 

1.27xl0 3 

97.4 

1.19xl0 3 

273 

1.32xl0 3 

271 

262 

-429 

-478 

-352 

622 

71.6 

78.7 
-633 

1.24xl0 3 

107 

1.15xl0 3 

264 

1.28xl0 3 

264 

255 

-409 

-454 

-328 

600 

71.0 

78.0 
-626 

1.23xl0 3 

110 

1.14xl0 3 

262 

l.27x!0 3 

262 

253 

-404 

-448 

-322 

595 

70.9 

78.0 

-625 

1.23xl0 3 

110 

1.14xl0 3 

262 

1.26xl0 3 

262 

253 

-404 

-448 

-321 

595 

70.9 

78.0 

-625 

1.23xl0 3 

110 

1.14xt0 3 

262 

1.26xl0 3 

262 

253 

-404 

-448 

-321 

595 

70.9 

78.0 

-625 

1.23xl0 3 

110 

1.14xl0 3 

262 

l.26xl0 3 

262 

253 

—404 

—448 

-321 

595 

70.9 

78.0 

-625 

1.23xl0 3 

110 

1.14xl0 3 

262 

1.26xl0 3 

262 

253 

—404 

—448 

-321 

595 

70.9 

78.0 

-625 

1.23xl0 3 

110 

I.l4xl0 3 

262 

1.26xl0 3 

262 

253 

-404 

-448 

-321 

595 




TABLE 13.15.— VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT (dYfipJ 
WITH EMAX FOR BENZENE-OXYGEN-ARGON EXAMPLE PROBLEM 
[ATOLSP = KT’EMAX, f = 300 (is.] 


Variable 

EMAX 


10“ 2 

10‘ 3 

10 -4 



10" 5 

10 -6 

10' 7 

HT® 

10“ 9 

10 -I0 


&yfl po> 

T 

5.50 

4.21 

4.07 

4.03 

4.03 

4.03 

4.03 

4.03 

4.03 

P 

7.12 

5.63 

5.47 

5.44 

5.43 

5.43 

5.43 

5.43 

5.43 

° c 6 H 6 

-56.0 

-37.6 

-36.1 

-35.7 

-35.6 

-35.6 

-35.6 

-35.6 

-35.6 

_ ° O 

°OH 

90.0 

71.7 

69.5 

69.0 

68.9 

68.9 

68.9 

68.9 

68.9 

° C 6 H 5 

-6.47 

5.19 

5.75 

5.90 

5.91 

5.9! 

5.91 

5.91 

5.91 

°H 

83.8 

66.4 

64.4 

63.9 

63.9 

63.9 

63.9 

63.9 

63.9 

°H, 

20.5 

15.2 

14.7 

14.6 

14.6 

14.6 

14.6 

14.6 

14.6 

°0 

95.1 

74.0 

71.6 

71.0 

70.9 

70.9 

70.9 

70.9 

70.9 

°h 2 o 

18.8 

15.5 

15.1 

15.0 

15.0 

15.0 

15.0 

15.0 

15.0 

°co 

18.8 

15.0 

14.6 

14.4 

14.4 

14.4 

14.4 

14.4 

14.4 

° C 2 H 2 

-36.2 

-24.2 

-23.0 

-22.7 

-22.7 

-22.7 

-22.7 

-22.7 

-22.7 

°c 6 h 5 oh 

-44.4 

-26.9 

-25.6 

-25.2 

-25.2 

-25.2 

-25.2 

-25.2 

-25.2 

<j c s h 6 

-37.9 

-20.2 

-18.8 

-18.5 

-18.4 

-18.4 

-18.4 

-18.4 

-18.4 

°co 2 

46.4 

35.4 

34.1 

33.8 

33.8 

33.8 

33.8 

33.8 

33.8 


TABLE 13.16 — VARIATION OF NORMAL IZED SENSITIVITY COEFFICIENT (d Y/dA , ) 
WITH EMAX FOR BENZENE-OXYGEN-ARGON EXAMPLE PROBLEM 
[ATOLSP = 10' 9 EMAX, / = 300 (is.] 


Variable 

EMAX 


10" 2 

10" 3 

10^ 

10" 5 

10" 6 

10“ 7 

KT® 

10- 9 

1Q-I0 


<3179A,> 

T 

2.67 

2.04 

1.98 

1.96 

1.96 

1.96 

1.96 

1.96 

1.96 

P 

2.97 

2.25 

2.18 

2.16 

2.16 

2.16 

2.16 

2.16 

2.16 

° C * H * 

-27.4 

-18.5 

-17.7 

-17.5 

-17.5 

-17.5 

-17.5 

-17.5 

-17.5 

o o 
°OH 

44.1 

35.3 

34.2 

34.0 

33.9 

33.9 

33.9 

33.9 

33.9 


-3.22 

2.50 

2.78 

2.85 

2.86 

2.86 

2.86 

2.86 

2.86 

D 5 

41.2 

32.8 

31.8 

31.6 

31.6 

31.6 

31.6 

31.6 

31.6 

°»2 

10.1 

7.51 

7.28 

7.23 

7.22 

7.22 

7.22 

7.22 

7.22 

°o 

46.6 

36.4 

35.3 

35.0 

34.9 

34.9 

34.9 

34.9 

34.9 

°h 2 o 

9.14 

7.55 

7.36 

7.31 

7.30 

7.30 

7.30 

7.30 

7.30 

a co 

9.17 

7.32 

7.11 

7.06 

7.06 

7.06 

7.06 

7.06 

7.06 

°c 7 h. 

-17.6 

-11.8 

-11.2 

-11.1 

-11.1 

-11.1 

-11.1 

-11.1 

-11.1 

L L 

^C^HcOH 

-21.7 

-13.2 

-12.6 

-12.4 

-12.4 

-12.4 

-12.4 

-12.4 

-12.4 

o 5 
a C 

-18.3 

-9.70 

-9.02 

-8.85 

-8.84 

-8.84 

-8.84 

-8.84 

-8.84 

_ 5 6 

°co 2 

22.5 

17.2 

16.7 

16.5 

16.5 

16.5 

16.5 

16.5 

16.5 
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TABLE 13.17.— VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT ( dr/dAJ 
WITH EMAX FOR BENZENE-OXYGEN-ARGON EXAMPLE PROBLEM 
[ATOLSP = lCr 9 EMAX, t = 300 |is] 


Variable 

EMAX 


10" 2 

10” 3 

10 -4 

10" 5 

KT 6 

10" 7 

KT 8 

10” 9 

KT 10 



T 

1.00 

0.765 

0.740 

0.733 

0.733 

0.733 

0.733 

0.733 

0.733 

P 

1.11 

0.843 

0.814 

0.807 

0.807 

0.807 

0.807 

0.807 

0.807 


- 10.6 

- 7.18 

- 6.89 

- 6.82 

- 6.81 

- 6.81 

- 6.81 

- 6.81 

— 6.81 

°OH 

16.4 

13.1 

12.7 

12.6 

12.6 

12.6 

12.6 

12.6 

12.6 

° C 6 H 5 

- 0.820 

1.33 

1.44 

1.47 

1.47 

1.47 

1.47 

1.47 

1.47 

O 3 

°H 

15.5 

12.3 

11.9 

11.8 

11.8 

11.8 

11.8 

11.8 

11.8 

% 

3.82 

2.85 

2.76 

2.74 

2.74 

2.74 

2.74 

2.74 

2.74 

°o 

17.4 

13.6 

13.2 

13.1 

13.1 

13.1 

13.1 

13.1 

13.1 

° H 2° 

3.44 

2.83 

2.76 

2.74 

2.74 

2.74 

2.74 

2.74 

2.74 

°CO 

3.45 

2.74 

2.67 

2.65 

2.64 

2.64 

2.64 

2.64 

2.64 

C C-,R, 

- 6.45 

- 4.28 

- 4.08 

- 4.03 

- 4.03 

- 4.03 

- 4.03 

- 4.03 

- 4.03 

i i 

a C^H<OH 

- 8.03 

- 4.81 

- 4.56 

- 4.49 

- 4.49 

- 4.49 

- 4.49 

- 4.49 

- 4.49 

O J 

°C,H , 

- 6.68 

- 3.45 

- 3.20 

- 3.14 

- 3.13 

- 3.13 

- 3.13 

- 3.13 

- 3.13 

J o 
0 CX) 2 

8.38 

6.37 

6.15 

6.10 

6.09 

6.09 

6.09 

6.09 

6.09 


TABLE 13.18 — VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT QYfiAJ 
WITH EMAX FOR BENZENE-OXYGEN-ARGON EXAMPLE PROBLEM 
(ATOLSP = 10- 9 EMAX, t = 300 ps.] 


Variable 

EMAX 

10' 2 

10“ 3 

10 ^ 

10" 5 

10 -6 

10“ 7 

10 "® 

KT 9 

10 - 1 ° 

QrflA „> 

T 

P 

%«6 

°OH 

° C 6 H 5 

°H 

°0 

°h 2 o 

°co 

° C 2 H 2 

°c 6 h 5 oh 

0 a> 2 

2.84 

3.15 

- 28.9 

47.2 
- 3.06 

44.2 

10.9 

49.9 
9.70 
9.75 

- 18.9 

- 23.3 

- 19.0 

24.1 

2.17 

2.39 

- 19.4 

37.8 

3.06 

35.2 

8.14 

39.1 

7.99 

7.76 

- 12.7 

- 14.3 

- 9.86 

18.4 

2.09 

2.31 

- 18.5 

36.6 

3.35 

34.2 

7.89 

37.8 
7.77 
7.54 
- 12.1 
- 13.6 
- 9.14 

17.8 

2.08 

2.29 

- 18.3 

36.3 

3.43 

33.9 

7.83 

37.5 
7.72 
7.48 
- 11.9 
- 13.4 
- 8.96 

17.6 

2.07 

2.28 

- 18.3 

36.3 

3.44 

33.9 

7.83 

37.5 
7.72 
7.48 
- 11.9 
- 13.4 
- 8.94 

17.6 

2.07 

2.28 

- 18.3 

36.3 

3.44 

33.9 

7.83 

37.5 
7.72 
7.48 
- 11.9 
- 13.4 
- 8.94 

17.6 

2.07 

2.28 

- 18.3 

36.3 

3.44 

33.9 

7.83 

37.5 
7.72 
7.48 
- 11.9 
- 13.4 
- 8.94 

17.6 

2.07 

2.28 

- 18.3 

36.3 

3.44 

33.9 

7.83 

37.5 
7.72 
7.48 
- 11.9 
- 13.4 
- 8.94 

17.6 

2.07 

2.28 

- 18.3 

36.3 

3.44 

33.9 

7.83 

37.5 
7.72 
7.48 
- 11.9 
- 13.4 
- 8.94 

17.6 




TABLE 13.19.— VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT <dr/9A |2 > WITH 
EMAX FOR BENZENE-OXYGEN-ARGON EXAMPLE PROBLEM 
[ATOLSP = Kr’EMAX, t = 300 | is.J 


Variable 

EMAX 


1 ( T 2 

10" 3 

10 -4 

10" 5 

KT 6 

10’ 7 

KT 8 

10" 9 

io-'° 


t2 ) 

T 

- 1.95 

- 1.49 

- 1.44 

- 1.43 

- 1.43 

- 1.43 

- 1.43 

- 1.43 

- 1.43 

P 

- 2.16 

- 1.64 

- 1.59 

- 1.57 

- 1.57 

- 1.57 

- 1.57 

- 1.57 

- 1.57 


19.8 

13.3 

12.8 

12.7 

12.6 

12.6 

12.6 

12.6 

12.6 

°OH 

- 32.2 

- 25.8 

- 25.0 

- 24.8 

- 24.8 

- 24.8 

- 24.8 

- 24.8 

- 24.8 


2.19 

- 1.99 

- 2.20 

- 2.25 

- 2.25 

- 2.25 

- 2.25 

- 2.25 

- 2.25 

O J 

- 30.1 

- 24.0 

“ 23.3 

- 23.1 

- 23.1 

- 23.1 

- 23.1 

- 23.1 

- 23.1 

% 

- 7.41 

- 5.56 

- 5.39 

- 5.35 

- 5.35 

- 5.34 

- 5.34 

- 5.34 

- 5.34 

*o 2 

- 34.0 

- 26.7 

- 25.8 

- 25.6 

- 25.6 

- 25.6 

- 25.6 

- 25.6 

- 25.6 

°h 2 o 

- 6.66 

- 5.50 

- 5.35 

- 5.32 

- 5.31 

- 5.31 

- 5.31 

- 5.31 

- 5.31 

°co 

- 6.67 

- 5.32 

- 5.18 

- 5.14 

- 5.13 

- 5.13 

- 5.13 

- 5.13 

- 5.13 


12.9 

8.70 

8.30 

8.20 

8.19 

8.19 

8.19 

8.19 

8.19 

L L 

C CAl* OH 

15.9 

9.71 

9.23 

9.11 

9.10 

9.09 

9.09 

9.09 

9.09 

O J 

c c,h 6 

13.3 

7.01 

6.52 

6.40 

6.39 

6.39 

6.39 

6.39 

6.39 

J o 
Cco 2 

- 16.5 

- 12.6 

- 12.2 

- 12.1 

- 12.1 

- 12.1 

- 12.1 

- 12.1 

- 12.1 


TABLE 13.20 — VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT <3F/3A |7 > 
WITH EMAX FOR BENZENE-OXYGEN-ARGON EXAMPLE PROBLEM 
[ATOLSP = lO^EMAX, / = 300 fis] 


Variable 

EMAX 

10~ 2 

10" 3 

10- 4 

10‘ 5 

KT 6 

10~ 7 

KT 8 

10“ 9 

KT 10 

@ 1794 , 7 } 

T 

P 

° C 6»6 

°OH 

° C 6 H 5 

°H 

°”2 

°0 

°h 2 o 

°co 

°c,h 2 I 

°c 6 h 5 oh 

° C 5 H 6 

° co 2 

1.58 

1.76 

- 15.9 

26.1 

- 1.65 

24.3 
6.02 
27.5 

5.42 

5.43 
- 10.3 
- 12.9 
- 11.1 

13.3 

1.21 

1.33 

- 10.7 

20.8 

1.72 

19.3 
4.49 

21.4 
4.47 
4.32 
- 6.81 
- 7.84 
- 6.03 

10.2 

1.17 

1.29 

- 10.2 

20.2 

1.88 

18.8 

4.35 

20.7 

4.35 

4.20 

- 6.49 

- 7.45 

- 5.63 

9.83 

1.16 

1.28 

- 10.1 

20.0 

1.93 

18.6 

4.32 

20.6 

4.32 

4.17 

- 6.40 

- 7.35 

- 5.53 

9.75 

1.16 

1.28 

- 10.1 

20.0 

1.93 

18.6 

4.31 
20.5 

4.32 
4.16 
- 6.40 
- 7.35 
- 5.52 
9.74 

1.16 

1.28 

- 10.1 

20.0 

1.93 

18.6 

4.31 
20.5 

4.32 
4.16 
- 6.40 
- 7.34 
- 5.52 
9.74 

1.16 

1.28 

- 10.1 

20.0 

1.93 

18.6 

4.31 
20.5 

4.32 
4.16 
- 6.40 
- 7.34 
- 5.52 
9.74 

1.16 

1.28 

- 10.1 

20.0 

1.93 

18.6 

4.31 
20.5 

4.32 
4.16 
- 6.40 
- 7.34 
- 5.52 
9.74 

1.16 

1.28 

- 10.1 

20.0 

1.93 

18.6 

4.31 
20.5 

4.32 
4.16 
- 6.40 
- 7.34 
- 5.52 
9.74 
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TABLE 13.21.— VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT WITH EMAX 

FOR BENZENE-OXYGEN-ARGON EXAMPLE PROBLEM 
[ATOLSP = 10 _9 EMAX, t = 300 jis.) 


Variable 


EMAX | 


10' 2 

10 -3 

IQT* 

10" 5 

ict 6 

10- 7 

1 \0~* 

KT 9 

10-'° 


QY/d A l8 > 


T 

-0.874 

-0.668 

-0.645 

-0.640 

-0.639 

-0.639 

-0.639 

-0.639 

-0.639 

P 

-0.971 

-0.734 

-0.709 

-0.703 

-0.702 

-0,702 

-0.702 

-0.702 

-0.702 


9.29 

6.32 

6.07 

6.01 

6.00 

6.00 

6.00 

6.00 

6.00 

°OH 

-14.8 

-11.9 

-11.6 

-11.5 

-11.5 

-11.5 

-11.5 

-11.5 

-11.5 

° C 6 H 5 

1.12 

-0.820 

-0.916 

-0.941 

-0.943 

-0.943 

-0.943 

-0.943 

-0.943 

°H 

-13.8 

-11.0 

-10.7 

-10.6 

-10.6 

-10.6 

-10.6 

-10.6 

-10.6 

°h 2 

-3.32 

-2.46 

-2.39 

-2.37 

-2.37 

-2.37 

-2.37 

-2.37 

-2.37 

«o 

-15.7 

-12.4 

-12.0 

-11.9 

-11.9 

-11.9 

-11.9 

-11.9 

-11.9 

° H 2° 

-2.96 

-2.43 

-2.36 

-2.35 

-2.34 

-2.34 

-2.34 

-2.34 

-2.34 

°CO 

-2.97 

-2.35 

-2.28 

-2.26 

-2.26 

-2.26 

-2.26 

-2.26 

-2.26 

ac 2 *h 

6.19 

4.27 

4.09 

4.05 

4.04 

4.04 

4.04 

4.04 

4.04 

°c 6 h 5 oh 

6.48 

3.70 

3.48 

3.42 

3.42 

3.42 

3.42 

3.42 

3.42 

° C 5 H 6 

5.91 

3.08 

2.86 

2.81 

2.80 

2.80 

2.80 

2.80 

2.80 

°C°2 

-7.54 

-5.78 

-5.58 

-5.53 

-5.53 

-5.53 

-5.53 

-5.53 

-5.53 


TABLE 13.22 — VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT $YftA m ) 
WITH EMAX FOR BENZENE-OXYGEN-ARGON EXAMPLE PROBLEM 
[ATOLSP = 10 _9 EMAX, t = 300 (is.] 


Variable 

EMAX 


10“ 2 

10’ 3 

10^ 

10" 5 

KT 6 

KT 7 

10"® 

I0" 9 

10-'° 


(dY/dA ]0 j) 

T 

1.26 

0.953 

0.921 

0.913 

0.912 

0.912 

0.912 

0.912 

0.912 

P 

1.40 

1.05 

1.01 

1.00 

1.00 

1.00 

1.00 

1.00 

1.00 

° C 6 H 6 

-13.0 

-8.72 

-8.35 

-8.26 

-8.25 

-8.25 

-8.25 

-8.25 

-8.25 

°OH 

21.1 

16.8 

16.3 

16.2 

16.2 

16.2 

16.2 

16.2 

16.2 

° C 6 H 5 

-1.26 

1.46 

1.59 

1.62 

1.62 

1.62 

1.62 

1.62 

1.62 

°H 

19.1 

15.0 

14.5 

14.4 

14.4 

14.4 

14.4 

14.4 

14.4 

% 

4.10 

2.86 

2.75 

2.73 

2.73 

2.72 

2.72 

2.72 

2.72 

°0 

22.6 

17.7 

17.2 

17.0 

17.0 

17.0 

17.0 

17.0 

17.0 

°h 2 ° 

4.33 

3.54 

3.45 

3.42 

3.42 

3.42 

3.42 

3.42 

3.42 

°co 

4.30 

3.39 

3.29 

3.27 

3.27 

3.27 

3.27 

3.27 

3.27 

°c 2 H 2 

-8.63 

-5.88 

-5.62 

-5.56 

-5.55 

-5.55 

-5.55 

-5.55 

-5.55 

^CtH^OH 

-10.1 

-6.05 

-5.74 

-5.66 

-5.65 

-5.65 

-5.65 

-5.65 

-5.65 

° C 5 H 6 

-8.82 

-4.72 

-4.39 

-4.31 

-4.31 

-4.31 

-4.31 

-4.31 

-4.31 

°co 2 

10.6 

8.07 

7.79 

7.72 

7.71 

7.71 

7.71 

7.71 

7.71 





TABLE 13.23 —VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT (BY/dn^ 
WITH EMAX FOR BENZENE-OXYGEN-ARGON EXAMPLE PROBLEM 
[ATOLSP = 10 _9 EMAX, / = 300 ms ] 


Variable 

EMAX 


10“ 2 

10" 3 

10^ 

10' 5 

10-* 

10‘ 7 

I0“ 8 

10" 9 

10-1° 



T 

2.86 

2.18 

2.11 

2.09 

2.09 

2.09 

2.09 

2.09 

2.09 

P 

3.18 

2.40 

2.32 

2.30 

2.30 

2.30 

2.30 

2.30 

2.30 

%, H 6 

°OH 

-29.1 

-19.5 

-18.7 

-18.5 

-18.4 

-18.4 

-18.4 

-18.4 

-18.4 

47.5 

38.0 

36.9 

36.6 

36.6 

36.6 

36.6 

36.6 

36.6 


-3.07 

3.08 

3.38 

3.46 

3.47 

3.47 

3.47 

3.47 

3.47 

6 5 

<^H 

44.5 

35.5 

34.4 

34.2 

34.1 

34.1 

34.1 

34.1 

34.1 


11.0 

8.20 

7.95 

7.89 

7.89 

7.88 

7.88 

7.88 

7.88 

2 

50.3 

39.3 

38.1 

37.7 

37.7 

37.7 

37.7 

37.7 

37.7 

°h 2 ° 

°co 

9.77 

8.04 

7.83 

7.77 

7.77 

7.77 

7.77 

7.77 

7.77 

9.82 

7.81 

7.59 

7.53 

7.53 

7.53 

7.53 

7.53 

7.53 

°c 2 h 2 

^H^OH 

-19.0 

-12.8 

-12.2 

-12.0 

-12.0 

-12.0 

-12.0 

-12.0 

-12.0 

-23.5 

-14.4 

-13.7 

-13.5 

-13.5 

-13.5 

-13.5 

-13.5 

-13.5 

_ O 5 
0C 5«6 

a co 2 

-19.1 

-9.91 

-9.19 

-9.00 

-8.99 

-8.99 

-8.99 

-8.99 

-8.99 

24.2 

18.5 

17.9 

17.7 

17.7 

17.7 

17.7 

17.7 

17.7 


TABLE 13.24 — VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT (BY/BE^) 
WITH EMAX FOR BENZENE-OXYGEN-ARGON EXAMPLE PROBLEM 
[ATOLSP = 10- 9 EMAX, t = 300 ps ] 


Variable 

EMAX 

10- 2 

10' 3 

10" 4 

10" 5 

KT 6 

10~ 7 

to -8 

10" 9 

nr 10 

QYflEj 

T 

P 

° C 6 H 6 

°OH 

° C 6 H 5 

°h 2 

°o 

° H 2° 

°CO 

aC 2 H 2 

°c 6 h 5 oh 

° C 5 H 6 

° C0 2 

2.70 

3.00 
-27.5 

44.8 
-2.95 

42.0 

10.4 

47.4 
9.24 
9.28 

-18.0 

-22.2 

-18.2 

22.9 

2.06 

2.28 

-18.5 

35.9 

2.87 

33.5 
7.74 
37.1 
7.61 
7.39 
-12.1 
-13.6 
-9.50 

17.5 

2.00 

2.20 

-17.7 

34.8 
3.16 
32.5 
7.50 

35.9 
7.41 
7.18 
-11.5 
-12.9 
-8.81 

16.9 

1.98 

2.18 

-17.5 

34.6 
3.23 
32.2 
7.45 

35.6 
7.36 
7.13 
-11.4 
-12.7 
-8.64 

16.8 

1.98 

2.18 

-17.5 

34.5 
3.23 
32.2 
7.44 

35.6 
7.36 
7.12 
-11.4 
-12.7 
-8.63 

16.8 

1.98 

2.18 

-17.5 

34.5 
3.24 
32.2 
7.44 

35.6 
7.35 
7.12 
-11.4 
-12.7 
-8.62 
16.8 

1.98 

2.18 

-17.5 

34.5 
3.24 
32.2 
7.44 

35.6 
7.35 
7.12 
-11.4 
-12.7 
-8.62 
16.8 

1.98 

2.18 

-17.5 

34.5 
3.24 
32.2 
7.44 

35.6 
7.35 
7.12 
-11.4 
-12.7 
-8.62 
16.8 

1.98 

2.18 

-17.5 

34.5 
3.24 
32.2 
7.44 

35.6 
7.35 
7.12 
-11.4 
-12.7 
-8.62 
16.8 



TABLE 13.25 — VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT 
<3iy3o c H o> WITH ATOLSP FOR BENZENE-OXYGEN-ARGON 
EXAMPLE PROBLEM 
[EMAX = 10 -6 , r = 300 ms ] 


Variable 

ATOLSP 


1C 15 

10-' 4 

10" 13 

1C 12 

10 _l 1 

10 -io 

10' 9 

I0~ 8 



T 

1.69 

1.69 

1.69 

1.69 

1.69 

1.69 

1.70 

1.75 

P 

1.88 

1.88 

1.88 

1.88 

1.88 

1.89 

1.90 

1.95 

° C 6 H 6 

-12.6 

-12.6 

-12.6 

-12.6 

-12.6 

-12.7 

-12.8 

-13.3 

— ° ° 
°OH 

28.3 

28.3 

28.3 

28.3 

28.3 

28.4 

28.5 

29.2 

° C 6 H 5 

4.07 

4.07 

4.07 

4.07 

4.07 

4.05 

4.02 

3.74 

°H 

27.3 

27.3 

27.3 

27.3 

27.3 

27.4 

27.5 

28.1 

°h 2 

7.74 

7.75 

7.74 

7.75 

7.75 

7.76 

7.79 

7.94 

°o 

28.9 

28.9 

28.9 

28.9 

28.9 

28.9 

29.1 

29.9 

°h 2 o 

6.59 

6.59 

6.59 

6.59 

6.59 

6.60 

6.63 

6.75 

°co 

6.43 

6.43 

6.43 

6.43 

6.44 

6.45 

6.48 

6.61 

° C 2 H 2 

-7.87 

-7.88 

-7.87 

-7.88 

-7.88 

-7.92 

-7.98 

-8.35 

°C,H,OH 

-9.39 

-9.39 

-9.39 

-9.40 

-9.40 

-9.45 

-9.53 

-10.0 

C 5 H 6 

-6.25 

-6.25 

-6.25 

-6.25 

-6.26 

-6.30 

-6.38 

-6.88 

°co 2 

14.0 

14.0 

14.0 

14.0 

14.0 

14.0 

14.1 

14.5 


TABLE 13.26 — VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT (diya<J H7O0 > WITH ATOLSP 
FOR BENZENE-OXYGEN-ARGON EXAMPLE PROBLEM 
[EMAX = 10" 6 , t = 300 ns.] 


Variable 


ATOLSP 


10~ 15 

10" 14 

io- 13 

10 -12 

[ 10‘ M 

,0-1° 

10 -9 

IO' 8 



(OK/Oo H2 o 0 ) 


T 

-7.52x10"* 

-7.52X10 -4 

-7.52x1c 4 

-7.52x1c -4 

-7.52X10 -4 

-7.54x1 0 -4 

-7.57X10 -4 

-7.78x10"* 

P 

-7.23x1 0~* 

-7.23XHT* 

-7.23x10"* 

-7.23x10"* 

-7.24x10"* 

-7.26x10"* 

-7.29x1 0 -4 

-7.53x10"* 

° C 6 H 6 

6. 12x1 O' 3 

6.13xl0~ 3 

6.12xl0~ 3 

6.13xl0 -3 

6.I3XI0' 3 

6.15xl0 -3 

6.19xl0“ 3 

6.44xl0 -3 

°OH 

-1.22xl0~ 2 

-1.22xl0" 2 

-1.22x1 0‘ 2 

-1.22xl0 -2 

-I.22xl0 -2 

-1.22xl0" 2 

-1.23xlO' 2 

-1.26x1 O' 2 

° C 6 H 5 

-1.07x1 O' 3 

-1.07xl0“ 3 

-1.07xl0~ 3 

-1.07xl0‘ 3 

-1.07xl0~ 3 

-1.06xl0~ 3 

-1.04xl0‘ 3 

-9.13x10"* 

°H 

-1.22xl0~ 2 

-1.22xl0~ 2 

-I.22xl0~ 2 

-1.22xl0 -2 

-1.22xl0 -2 

-I.22xl0 -2 

-l.22xlC 2 

-I.25xl0‘ 2 

°h 2 

-1.40xl0 -3 

-1.40xl0“ 3 

-1.40xl0 -3 

-1.40xl0 -3 

-1.40xl0 -3 

-1.40xl0 -3 

-I.41xl0 -3 

-1.47xl0 -3 

°o 

-1.38xl0 -2 

-I.38xl0 -2 

-1.38xl0 -2 

-1.38xl0 -2 

-I.38xl0~ 2 

-I.39xl0 -2 

-1.39x1 0‘ 2 

-1.43xl0~ 2 

a H20 

2.85xlO" 3 

2.85X10* 3 

2.85X10' 3 

2.85xlO" 3 

2.85xl0 -3 

2.84xl0 -3 

2.82xl0 -3 

2.72xl0 -3 

°CO 

-2.47xl0~ 3 

-2.47xl0 -3 

-2.47xl0 -3 

-2.48xl0 -3 

-2.48x1 O' 3 

-2.48xlO" 3 

-2.49xl0~ 3 

-2.56xl0~ 3 

° C 2 H 2 

4.42x1 0‘ 3 

4.42x1 0 -3 

4.42x1 0 -3 

4.42x1 0‘ 3 

4.42x1 O' 3 

4.44x1 0 -3 

4.46xl0 -3 

4.63xlO~ 3 

a C 6 H 5 OH 

4. 14x1 O' 3 

4.14XI0 -3 

4. 14x1 0‘ 3 

4.I4XI0" 3 

4.14xl0~ 3 

4.16xl0‘ 3 

4.19xlC 3 

4.42x1 O' 3 

° C 5 H 6 

3.17xlO -3 

3.17xl0 -3 

3.17xl0" 3 

3. 17x1 O' 3 

3.l7xIO -3 

3.19xl0~ 3 

3.22xl0 -3 

3.44xlC 3 

°co 2 

-5.84x1 0“ 3 

-5.84xl0 -3 

-5.84xl0 -3 

-5.84xl0 -3 

-5.84xl0' 3 

-5.86xl0' 3 

-5.88xl0 -3 

-6.05x1 0 -3 
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TABLE 13.27.— VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT (dYfiTJ WITH ATOLSP 
FOR BENZENE-OXYGEN-ARGON EXAMPLE PROBLEM 
[EMAX = 10" 6 , t = 300 (is.) 


Variable 

ATOLSP 


10- 15 

I0" 14 

10' 13 

10"' 2 

10‘" 

10-1° 

10- 9 

10' 8 


W 0> 

T 

70.9 

70.9 

70.9 

70.9 

71.0 

71.1 

71.5 

73.3 

P 

78.0 

78.0 

78.0 

78.0 

78.0 

78.2 

78.6 

80.7 


-625 

-625 

-625 

-625 

-626 

-628 

-631 

-655 

6 6 
°OH 

1.23x10 s 

1.23xl0 3 

1.23X10 3 

1.23x10 s 

1.23x10 s 

1.23x10 s 

1.23x10 s 

1.26x10 s 


110 

110 

110 

110 

110 

109 

108 

95.4 

6 5 

1.14xl0 3 

I.14xl0 3 

1.14X10 3 

1.14x10 s 

1.14x10 s 

1.14x10 s 

1.15x10 s 

1.18x10 s 


262 

262 

262 

262 

262 

263 

264 

270 

2 

°0 

1.26xl0 3 

1.26xl0 3 

1. 26x10 s 

1.27x10 s 

1.27x10 s 

1.27x10 s 

1.27x10 s 

1.31x10 s 

° H 2° 

262 

262 

262 

262 

262 

262 

263 

268 

°CO 

253 

253 

253 

253 

253 

253 

254 

260 

°c,h 9 

-404 

-404 

-404 

-404 

-404 

-405 

-408 

-424 

L L 

^CgHjOH 

-448 

—448 

—448 

-448 

-448 

-450 

-453 

-475 

° C 5 H 6 

-321 

-321 

-321 

-321 

-322 

-323 

-326 

-348 

a co 2 

595 

595 

595 

595 

595 

597 

600 

615 


TABLE 13.28 — VARIATION OF NORMAL IZED SENSITIVITY COEFFICIENT 
(3K/3A,) WITH ATOLSP FOR BENZENE-OXYGEN-ARGON EXAMPLE PROBLEM 
[EMAX = 10 -6 , t = 300 ps.] 


Variable 

ATOLSP 


10 -15 

10-' 4 

10 _1S 

10" 12 

10-" 

10“ 10 

10"* 

10" 8 


QYflA x ) 

T 

1.96 

1.96 

1.96 

1.96 

1.96 

1.97 

1.97 

2.03 

P 

2.16 

2.16 

2.16 

2.16 

2.16 

2.16 

2.17 

2.23 


-17.5 

-17.5 

-17.5 

-17.5 

-17.5 

-17.6 

-17.7 

-18.3 

°OH 

33.9 

33.9 

33.9 

33.9 

34.0 

34.0 

34.2 

35.0 

a c 6 H 5 

2.86 

2.86 

2.86 

2.85 

2.85 

2.83 

2.80 

2.45 

O J 

a H 

31.6 

31.6 

31.6 

31.6 

31.6 

31.7 

31.8 

32.5 

% 

a O 

7.22 

7.22 

7.22 

7.23 

7.23 

7.24 

7.28 

7.44 

34.9 

35.0 

34.9 

35.0 

35.0 

35.1 

35.2 

36.1 

c h 2 o 

7.30 

7.30 

7.30 

7.30 

7.31 

7.32 

7.35 

7.49 

°co 

7.06 

7.06 

7.06 

7.06 

7.06 

7.08 

7.11 

7.26 

° C 2 H 2 

-11.1 

- 11.1 

-11.1 

-11.1 

-11.1 

-11.1 

-11.2 

-11.7 

^CAi.OH 

-12.4 

-12.4 

-12.4 

-12.4 

-12.4 

-12.5 

-12.5 

-13.1 

O J 

-8.84 

-8.84 

-8.84 

-8.85 

-8.85 

-8.90 

-8.99 

-9.59 

_ J o 
° C0 2 

16.5 

16.5 

16.5 

16.5 

16.5 

16.6 

16.6 

17.1 
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TABLE 13.29.— VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT 
(3T,/3n g ) WITH ATOLSP FOR BENZENE-OXYGEN-ARGON 
EXAMPLE PROBLEM 
[EMAX = 10 -6 , r = 300 (is.] 


Variable 

ATOLSP 


1(T 15 

!0- 14 

10-' 3 

10-' 2 

10"" 

10 -i° 

10~ 9 

icr 8 


(dY/drtJ 


T 

2.09 

2.09 

2.09 

2.09 

2.09 

2.10 

2.10 

2.16 

P 

2.30 

2.30 

2.30 

2.30 

2.30 

2.31 

2.32 

2.38 

° C 6 H 6 

-18.4 

-18.5 

-18.4 

-18.5 

-18.5 

-18.5 

-18.6 

-19.3 

°OH 

36.6 

36.6 

36.6 

36.6 

36.6 

36.7 

36.8 

37.7 

° C 6 H 5 

3.47 

3.47 

3.47 

3.46 

3.46 

3.43 

3.40 

3.02 

°H 

34.1 

34.1 

34.1 

34.1 

34.2 

34.2 

34.4 

35.2 

°«2 

7.89 

7.89 

7.89 

7.89 

7.89 

7.91 

7.94 

8.12 

a O 

37.7 

37.7 

37.7 

37.7 

37.7 

37.8 

38.0 

39.0 

°h 2 o 

7.77 

7.77 

7.77 

7.77 

7.77 

7.79 

7.82 

7.97 

c co 

7.53 

7.53 

7.53 

7.53 

7.53 

7.55 

7.58 

7.75 

Cc 2 H 2 

-12.0 

-12.0 

-12.0 

-12.0 

-12.0 

-12.1 

-12.1 

-12.6 

°c 6 h 5 oh 

-13.5 

-13.5 

-13.5 

-13.5 

-13.5 

-13.5 

-13.6 

-14.3 

° C 5 H 6 

-8.99 

-8.99 

-8.99 

-9.00 

-9.00 

-9.06 

-9.15 

-9.79 

°co 2 

17.7 

17.7 

17.7 

17.7 

17.7 

17.8 

17.8 

18.3 


TABLE 13.30 — VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT 

<aiya£ 8 > with atolsp for benzene-oxygen-argon 

EXAMPLE PROBLEM 
[EMAX = HT 6 , t = 300 ms.] 


Variable 

ATOLSP 


HT 15 

10-' 4 

1(T 13 

10" 12 

lO -11 

lor 10 

10* 9 

1(T 8 


(Sr/dEg) 

T 

1.98 

1.98 

1.98 

1.98 

1.98 

1.98 

1.99 

2.05 

P 

2.18 

2.18 

2.18 

2.18 

2.18 

2.18 

2.19 

2.25 

° C 6 H 6 

-17.5 

-17.5 

-17.5 

-17.5 

-17.5 

-17.5 

-17.6 

-18.3 

a OH 

34.5 

34.5 

34.5 

34.5 

34.6 

34.6 

34.8 

35.6 

° c 6 H 5 

3.23 

3.23 

3.23 

3.23 

3.23 

3.20 

3.17 

2.82 


32.2 

32.2 

32.2 

32.2 

32.2 

32.3 

32.4 

33.2 

°«2 

7.44 

7.44 

7.44 

7.44 

7.45 

7.46 

7.49 

7.66 


35.6 

35.6 

35.6 

35.6 

35.6 

35.7 

35.9 

36.8 

°h 2 ° 

7.36 

7.36 

7.36 

7.36 

7.36 

7.37 

7.40 

7.55 

°co 

7.12 

7.12 

7.12 

7.12 

7.13 

7.14 

7.17 

7.33 

° C 2 H 2 

-11.4 

-11.4 

-11.4 

-11.4 

-11.4 

-11.4 

-11.5 

-11.9 

a C*H<OH 

-12.7 

-12.7 

-12.7 

-12.7 

-12.7 

-12.8 

-12.8 

-13.5 

C 5 H 6 

-8.63 

-8.63 

-8.63 

-8.63 

-8.64 

-8.69 

-8.78 

-9.38 

°co 2 

16.8 

16.8 

16.8 

16.8 

16.8 

16.8 

16.9 

17.3 




Appendix A 

Ordinary Differential Equations and 
Jacobian Matrix Elements 


In this appendix we list the ordinary differential equations 
used in the code for static and one-dimensional flow kinetics 
problems- For both problem types and for sensitivity analy- 
sis computations and the perfectly stirred reactor (PSR) prob- 
lem, we give the partial derivatives required by the numerical 
solution procedures. 

Net Reaction Rates and 
Partial Derivatives 


In these equations p is the mixture mass density, a, is the 
mole number of species i (i.e., number of moles of species i 
per unit mass of mixture), and kj and k-j are the forward 
and reverse rate coefficients of reaction j, with k-j = kj/K c j , 
where K CJ is the concentration equilibrium constant for reac- 
tion j (see eqs. (8.5) and (8.6)). In equations (A3) and (A4) 
we have used the fact that the molar concentration of 
species l, Q, can be written as 

C £ = p (A5) 


Non-Third-Body Reaction 

We write the general reaction equation in the form 


The partial derivatives of r } with respect to the {a^}, tem- 
perature 7, and density p are as follows: 


V U S 1 +V 2 , S 2 


v" Q +v" Q 
V 3j 3 + V 4y 4 


(Al) 


where 1 and 2 are the specific reactant subscripts and 3 and 4 
the specific product subscripts for reaction j, vjy and vjj are 
the stoichiometric coefficents of reactant species i and prod- 
uct species i, respectively, in reaction j, and 2, is the chemical 
symbol for species i. The net molar rate of reaction j per unit 
volume rj is given by (see eqs. (2.16) to (2.18) in chapter 2 of 
part I) 

r^Rj-R-j < A2 > 


where the molar forward Rj and reverse R-j rates per unit 
volume of reaction j are 


3r. _ VqRj 


()Of Of 


l = 1.2 


(A6) 


a 0 _ V 1 R J 


dOe 


Of 


, ( = 3,4 


(A7) 


drj Jin k ■ 


r, 


+ R_ 


Jin K r , 

L ■ J 


dT 1 dT dT 


(A8) 


/ U ' '2j R V 3j + V 4; 


drj v; ; +v; ; 

8p 


R 


(A9) 


Rj =k/' jW2i O^O 


R_ J =k_/ iJ+V4l of>o'^ 


(A3) 

(A4) 


In equation (A8) the derivative Jin K c JdT is given by 


^ K c .j 

dT 



f=3 


fc/ 0 

2 

.Yv) 

f 0 

RT 2 T) 

1 €=i 

[rt 2 t j 


(A10) 
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A. Ordinary Differential Equations and Jacobian Matrix Elements 
where is the molar-specific enthalpy of species £ y R is the 
universal gas constant, and din kj/dT depends on the form of 
the expression (eq. (8.3) or (8.4)) used for ky For a rate coef- 
ficient given by equation (8.3) 


d\n kj rij E - 

dT T 


(All) 


is a correction for the preexponential factor Aj of the rate 
coefficient expression (eq. (8.3) or (8.4)) and is defined by 


% = 



(A 18) 


and for kj of the form given by equation (8.4) 
(Rn kj rij 


If either species Q\ or S 4 , or both, are absent, the required 
derivatives can be obtained from equations (A3) to (A10) by 
simply setting the appropriate stoichiometric coefficient or 
coefficients equal to zero. Similarly setting k-j equal to zero 
gives the correct derivatives for an irreversible reaction. 

Third-Body Catalyst Reaction 

Two types of third-body reactions are considered: disso- 
ciation, written as 


Here (A y )^ and (Ay) 0 are the Aj values for species ^and a ref- 
erence species (usually nitrogen or an inert species such as 
argon) as the collision partner, respectively. It is (Aj) 0 that is 
specified in the rate coefficient data for the reaction. 

The molar forward and reverse rates per unit volume of 
reaction (A 15) are 


Rj = kjMjp v,J+y,2J+l c\ tJ a2 2J 

(A19) 

Af ; p V « +v; > +l c^C?> 

(A20) 


The net molar reaction rate per unit volume is given by 
equation (A2). The partial derivatives are as follows: 


M + v^S 2 * v^S 3 + v" -fi 4 + M (A1 3) 

and recombination, written as 

M + v^Sj + v' ; fi 2 * v" .S 3 + M (A14) 

The catalyst collision partner M can be any species present in 
the mixture. For convenience, we generalize the two reaction 
types as follows: 


M + vjyfij + v^S 2 * v^S 3 + v^S 4 + M (A15) 

where v\j and v 4 y are equal to zero for dissociation and 
recombination reactions, respectively. 

The total molar concentration C m of catalyst species is 
given by 


C m = pMj (A 16) 

where Mj is the third-body efficiency factor for the j th 
reaction 


NS 

(a i7) 

£=i 


NS is the total number of (reacting and inert) species, and 
the relative collisional efficiency of species l in reaction j, 


dog Mj J Gg J 

£ = l,2 

(A21) 

II 

O 

1 

Q 1 < 

> — 

II 

U> 

4^ 

(A22) 


+v ; +I * 

(A23) 

dp P j 

p 

and drjldT is given by equation (A8). 

Now Mj is a function 


of the mole numbers of all NS species (see eq. (A 17)), even 
those participating in the reaction as only third-body cata- 
lysts. Hence partial derivatives of rj with respect to the mole 
numbers of the latter species must also be included. These 
derivatives are given by 


dr j _ *(j r 
ddp M , 

1 J 


(A24) 


where species £ is a third-body catalyst. 

For a third-body dissociation reaction species is absent 
and the required equations are obtained by setting vjy equal 
to zero in equations (A 19) to (A23). Similarly setting v 4 ) 
equal to zero gives the correct equations for a third-body 
recombination reaction, which does not contain species 2 4 . 
Finally, for an irreversible reaction of either type, k~j = 0 
produces the desired results. 
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Ordinary Differential Equations 


Ordinary Differential Equations 


For ease of presentation in the following sections, we write 
the system of ordinary differential equations (ODE’s), equa- 
tion (3.1) in chapter 3 of part I, in component form: 

% = i = l—,N (A25) 

where the independent variable £, is either time t or distance x, 
the dependent variables {y/} are as follows: 



(A33) 


If sensitivity analysis with respect to the initial mole num- 
ber of any inert species is required, ODE’s are included for 
the mole numbers of all inert species. Each such ODE is 
given by ft = 0 (i = 1,...,NINERT, where NINERT is the num- 
ber of inert species). 

Static Reaction 

Assigned pressure . — We define 


y ( = O-, i = l,...,NRSorNS (A26) 

and NRS is the number of reacting species. The remaining 
dependent variables, if any, are one or more of T, p, and ve- 
locity V depending on the type of problem being solved. The 
number N of ODE’s also depends on the problem type. The 
following simplified notation will be used for the derivatives: 


NRS 


i= 1 


(A34) 


NRS 

i=i 


— '—/■ 
RT ' 


(A35) 


i = 1,...,NRS or NS 


/nt 


dT 

4 


/nr 


dp 

d\ 


(A27) 


(A28) 


(A29) 


and 



mRT 


(A36) 


In these equations M w is the mixture molar mass, Q is the 
heat transfer rate from the reacting mixture to its surround- 
ings, and m is the mass of the mixture. The required tem- 
perature and density derivatives can then be written as 


_dV_ 


(A30) 


/nt ~ 


T ( a m dp 
c p //?[ p dt 



(A37) 


Species Differential Equations 

The ODE for the mole number of the ith reacting species 
can be written as 


NR 


fi=— X©ir * = 

rw J 


NRS 


(A31) 


P*P 


where % depends on the independent variable 


1. $ = ' 

V, £, = x 


(A32) 


NR is the number of reactions, and (0 y is the net molar rate of 
formation of species i per unit volume by reaction j 


( 


/nr ” P 

V 


1 d p 

pdt 


ft 


NT 


(A38) 


where c p is the mixture mass-specific heat, equation (12.5), 
o m (= 1 IM W ) is the sum of the species mole numbers, and p is 
the pressure. In equation (A38) /n t is either given by equa- 
tion (A37) or computed from the temperature profile for an 
assigned-temperature problem. In the latter case equation 
(A37) is not used. However, if the temperature is constant 
and sensitivity coefficients with respect to its initial value are 
required, the temperature ODE /n t = 0 is included in the 
equation set. 

Constant density . — For this case, we redefine S\ as 

follows: 


NRS 

s, = £/, < A39 > 

1=1 
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A. Ordinary Differentia! Equations and Jacobian Matrix Elements 
The temperature derivative is then given by 

fm ‘ C m-o (*'- s 2-°) (A40) 

p 

where S2 and Z> are given by equations (A35) and (A36), 
respectively. 

If temperature is assigned, the species ODE’s completely 
specify the problem and equation (A40) is not needed. How- 
ever, if sensitivity analysis with respect to the initial tempera- 
ture is required for a constant- temperature problem, the com- 
ments given for the assigned-pressure static problem apply. 
Similarly, if sensitivity coefficients with respect to the initial 
density must be computed, the density ODE / NR = 0 is used. 


Z = 


v-i 

Y 


Ks 2 


(A46) 


V = M W 


Y - 1 V Q! 
y X mRT 


(A47) 


where y is the frozen mixture specific heat ratio, equa- 
tion (12.4). The temperature, density, and velocity deriva- 
tives are then as follows: 


ft 


NT 


-71 


(y-iH 2 

M 2 -\ 


1 dA . _ 
A 




\ + & + © 


(A48) 


Flow Problem 

Assigned pressure. — We define S\ and S2 by equations 
(A34) and (A35), respectively, and V as 


ft 


NR 


-P 


dr 


d4 2 — 1 ^ 


I dA 




+/t -T> 


(A49) 


^ V O' 

T> = (A41) 

X mRT 

m 

where Q ' is the heat transfer rate per unit length from the 
reacting mixture to its surroundings, m is the mass flow rate, 
and % depends on the independent variable (see eq. (A32)), 
The temperature, density, and velocity derivatives can then 
be expressed as 


/nv " ‘ 


OT-1 


1 dA 


(A50) 


where dA is the Mach number, equation (12.3), and A is the 
area. 

Assigned area and temperature . — Here S\ is given by 
equation (A34) and the density and velocity derivatives are 


/nt - 


c p /R 


°m dp 
P " 2 


(A42) 


ft 


-P 


NR “ , 

ydl 2 - 1 


Y-^ 2 dA /nt 

A dl % 1 7 


(A51) 


/nr -P 


( 1 dp ~ /nt ^ 

-p£, 


(A43) 


/nv=-^I 


^ 1 dA + / NR ^ 
Adt, p 


(A52) 


/nv ~ 


J _dP r 
pv dt, f 


(A44) 


where/^x is either equal to zero for a constant-temperature 
problem or computed from the assigned-temperature profile. 


where Cy(= 1.01325X10 6 dyne cm 2 /atm) is a units conver- 
sion factor. 

If temperature is assigned, equation (A42) is not used and 
/nt in equation (A43) is computed from the temperature pro- 
file. For a constant-pressure problem the velocity is also con- 
stant (see eq. (A44)), and so a velocity ODE is not solved. 

Assigned area. — For this problem type also S \ and S2 
are given by equations (A34) and (A35), respectively. In ad- 
dition, we define the quantities 

,4 = S x - & (A45) 


Jacobian Matrix Elements 

We list here the equations used to calculate the Jacobian 
matrix elements for the various static and flow problem types 
considered in this work. The equations are obtained by dif- 
ferentiating the appropriate equations for {//},/nt»/nR’ and 
/nv- For the sake of generality we derive expressions for all 
possible Jacobian matrix elements for each problem type. 
However, the elements that are actually needed, and therefore 
computed, depend on the variables, including sensitivity 
analysis data, specified for the problem. The ODE solver 
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requires the partial derivatives dfi/dyj, ij = 1 The ODE 
set contains quantities that are required for the problem and 
vary during the course of the reaction. A constant quantity is 
also included in the ODE list if sensitivity analysis with 
respect to its initial value is required. For each such variable 
the partial derivatives of its temporal derivative with respect 
to all variables are zero, and therefore the equations given in 
this section are not used. They are, however, used to com- 
pute the partial derivatives with respect to this variable. 

Partial Derivatives of Species Formation Rates 

The partial derivatives of the species formation rates {/,} 
with respect to species mole numbers are computed from 
equations (A3 1) and (A33). For any reacting species £ 





, NR 

J-Y( V " 

nv^V V 


pxp 




ij = 1,...,NRS 


(A53) 


where % depends on the independent variable (see eq. (A32)) 
and drj/dog depends on the reaction type and whether 
species ( is a reactant or a product (see eqs. (A6), (A7), 
(A21), and (A22)). If partial derivatives with respect to an 
inert species mole number are required, they are also com- 
puted by using equation (A53) but with drj/dat given by 
equation (A24). 

Equations (A31) and (A33) can also be used to derive the 
following expressions for [dfi/dT], [dfj/dp ( , and for a flow 
problem {dfi/3V}: 


A 

3p 


, NR 

dT px^-' 11 v '3 T 

r * 7=1 


i NR , 3r f 

-lyfv'-v'. 

px“J ,J "'ap p 


A 

dV 


0, l; = t 



i = 1,...,NRS 


i = 1,...,NRS 


i = 1,...,NRS 


(A54) 


(A55) 


(A56) 


a/NT _ 1 

dcff c p !R 




d<5f ()Of J 
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i = 1,...,NRS or NS 


(A57) 





( 


3/ nt 

1 

T 

y s }i_A + -L±Q 

3r 

c p /R 
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(A58) 


a/ NT T r q m idp + ds 2 1 dv" 

3p c p IR y p p dt dp 3p j 


(A59) 


In these equations c p _, is the molar-specific heat of species i. 
We use equation (A38) to compute the partial derivatives of 
/nr: 


a/NR _ 

tot 


-p 


dGo 


l i a/ NT ^ 

T to e 


£ = 1,...,NRS or NS 


(A60) 


a/NR _ 
dT 


3S. 1 
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dT T 

(dT T j J 


(A61) 


a/NR _ /nr p a^i { 1 3/^ 
3p P 3p T 3p . 


(A62) 


In equations (A57) to (A62) the required partial derivatives 
of Si, -£>2> and c p are as follows: 


where drj/dT is given by equation (A8) and 3 r -j! 3 p depends 
on the reaction type (see eqs. (A9) and (A23)). 

Static Reaction 

Assigned pressure . — The partial derivatives of/NT are 
obtained from equation (A37), after first replacing the term 
O m /p by \/(pRT) using the ideal-gas law: 


3S, 

to £ 




NRS zs 

Y v, 
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(A64) 
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K NRS 

; = 1 


9p 


^ = yil. 

5(7^ RT do^ 


£ = 1,...,NRS or NS 


^ = yAJ£. 

5p RT 5p 


JL^p. = y o - Cp,t 
5r /? ‘ dT r 


NS 

I 

/=1 


a <V 


(A65) 


(A66) 


(A67) 


(A68) 


The partial derivatives of the heat transfer terms depend on 
the heat transfer model. If the heat transfer rate is specified 
by the polynomial expression, equation (8.21), the required 
derivatives are as follows: 


52? 


52? 

5p 


2 ? 

P 


(A74) 


Equations (A72) and (A73) are also used in the situation of 
turbulent flow, but 


^ = -0.2® 
BP P 


(A75) 


In equations (A72) and (A73), we have neglected the implicit 
dependence of Q on {a,} and T through (see eqs. (8.24) to 
(8.30)). This approximation was made for the sake of sim- 
plicity to avoid the computational cost of evaluating the exact 
derivatives, which are excessively complicated (see eqs. 
(8.37) to (8.44)). 

Constant density. — For this problem type the only addi- 
tional partial derivatives required are those of far, which are 
evaluated from equation (A40): 
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(A71) 


i = 1 NRS or NS 


(A76) 




/ 


\ 

$ 

H 

II 

T 

55. 

NRS , 

_y Ai 

“ RT 5 T 

i=l 

1 d Q 

5 T c //? — a 

p m 

i 

dT 

RT dT m 


For presentational convenience we will refer to this heat 
transfer model as HTl. For the static Otto-cycle problem the 
heat transfer rate per unit mass of mixture is given by the 
empirical correlation, equation (8.29). For this heat transfer 
model, which is hereinafter referred to as HT2, the heat trans- 
fer coefficient and hence the required partial derivatives 
depend on the nature of the flow inside the cylinder. For 
laminar flow the following partial derivatives are used in the 
code: 
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= 0, £ = 1 NRS or NS 
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In equations (A76) to (A78) the partial derivatives of S\ 
(A72) are 
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The terms 3^2/90^, 3S2/3p, and d(c p fR)ldT are given, re- 
spectively, by equations (A66), (A67), and (A68). Finally, 
because HT1 is the only heat transfer model allowed for this 
problem type, the derivatives of the heat transfer terms are 
given by equations (A69) to (A71). 


Flow Problem 
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(A89) 


Assigned pressure . — In this case the required partial deriv- 
atives are calculated from equations (A42) to (A44), after 
first replacing the term o m /p by \/(pRT) in equation (A42), 
and are as follows: 


3/nt _ 1 

c p IR 

l = 1,...,NRS (A82) 
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(A91) 

(A92) 

(A93) 


In equations (A82) to (A84) and (A86) to (A88) the required 
partial derivatives of S i, S 2 , and CpfR are given by equa- 
tions (A63) to (A68) and 


+ 





(A83) 
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(A94) 
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3/nt 7 35 2 | 3Z?^ 

dV c p /R 3V 3V j 


where dfifdV depends on the independent variable (see 
eq. (A56)). The heat transfer terms depend on the heat trans- 
(A85) fer model and the independent variable (see eq. (A41)). For 
HT1 the required derivatives are as follows: 
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f? = 1,...,NRS (A103) 


For HT2 and laminar flow dZ>/a^, 3ZV3p, and 3 Z>/dV are, 
respectively, given by equations (A96), (A98), and (A99), 
and 


dT 


(A 100) 


The expressions for dV/dcg and dQ'/dT remain unchanged 
in the turbulent case but 
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ff + Z> 3y 
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(A104) 


d/ N T _ T 

Assigned area . — The partial derivatives of /nt and /nr 2 | 

are obtained from equations (A48) and (A49), but those of 
/nv are computed by using the simplified expression, equa- 
tion (A52), for this derivative: (A 105) 
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In equations (A103) to (A 1 10) the partial derivatives of S\ 
are given by equations (A63) to (A65) and (A94), and those 
of M 2 , y, and 8 are as follows: 
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(A 121) 


For HT2, dQ'/dT is given by equation (A 100) for both lami- 
nar and turbulent flows, but the other partial derivatives 
depend on the nature of the flow. Equations (A126) and 
(A 127) apply in the case of laminar flow, but for turbulent 
flow 
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Assigned area and temperature . — For this problem type 
(A 122) l| ic required partial derivatives are computed from equations 
(A51) and (A52) and are as follows: 
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In these equations the partial derivatives of Si and Cp/R are 
given by equations (A66) to (A68) and (A95). 

The partial derivatives {dV/dop} and dV/dT in equations 
(A103), (A107), and (A108) are given by 
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The partial derivatives dQ'/dT, dV/dp, and dZ>/dV in equa- 
tions (A104) to (A106), (A 109), (A1 10), and (A 125) depend 
on the heat transfer model. For HT1, dQ'/dT is given by 
equation (A97) and 
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In equations (A 130) to (A 132) and (A 134) the partial deriva- 
tives of Si are given by equations (A63), (A65), and (A94), 
and 
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(A1 37) In these equations Si and S 2 are given by equations (A34) 
and (A35), respectively, r|y is any one of Aj, nj, Ej, and Cj, and 


Sensitivity Analysis 

The numerical solution procedure described in chapter 4 of 
part I for the sensitivity coefficients requires the partial de- 
rivatives with respect to the rate coefficient parameters of the 
temporal derivatives of the dependent variables. These vari- 
ables depend on the problem type — assigned pressure or con- 
stant density — and whether temperature has been assigned. 
The partial derivatives of the species formation rates are 
independent of the problem type and are derived from equa- 
tion (A31), where x = 1 because £, = t. The derivatives with 
respect to the rate coefficient parameters of reaction j, Aj, nj , 
and Ej or cj (see eqs. (8.3) and (8.4)), are as follows: 

= i = 1,...,NRS (A138) 
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where 3/j/3r|j depends on r\j (see eqs. (A 138) to (A 141)). 
Finally, in equation (A 143) 3 /nt/3t]j is either given by equa- 
tion (A142) or zero for an assigned-temperature problem. 

Constant-Density Static Problem 

In this case the only additional partial derivatives required 
are those of/Ni% if T is not assigned, and are derived from 
equation (A40) 
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In these equations to y is given by equation (A33). 


^nt _ ^ 3^1 ds 2 


(A146) 


where S\ and S 2 are given by equations (A39) and (A35), 
respectively. 


<^ L= y S ^4_ 


(A147) 


dS^^j is given by equation (AMS), and 3/,/3r| 7 depends on 
r\j (see eqs. (A 138) to (A 141)). 


Assigned-Pressure Static Problem 

For this problem type the additional partial derivatives 
required are those of / nt> if T is not assigned, and/ NR and are 
obtained from equations (A37) and (A38): 


3/[sjt _ ^ 3*2 

3r| y c p lR 3ti j 
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Perfectly Stirred Reactor Problem 

The numerical solution procedure for this problem requires 
the partial derivatives of the N (= NRS + 1) functionals (^}, 
equations (7.14a) and (7.14b) in chapter 7 of part I, with re- 
spect to the dependent variables. These variables are the re- 
acting species mole numbers, o, (/ = I,...,NRS) and either 
temperature for an assigncd-mass-flow-rate problem or mass 
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flow rate for an assigned-temperature problem. In addition, 
for reasons discussed in chapter 7 (section 7.2) of part I, the 
partial derivatives with respect to the density must be in- 
cluded. The partial derivatives with respect to the species 
mole numbers are independent of the problem type. They are 
derived from equations (7.14a) and (7.14b) and are as fol- 
lows: 
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i,£ = 1.....NRS 
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(A148) 

In these equations dr/dT is given by equation (A8), dr/d p is 
given by either equation (A9) or (A23), and because HT1 is 
the only heat transfer model allowed for PSR problems 
(A 149) dQ/dT is given by equation (A70). 


In equation (A 148), drjldog depends on the reaction type and 
whether species £ is a reactant or a product (see eqs. (A6), 
(A7), (A21), and (A22)); drj/dp also depends on the reaction 
type (see eqs. (A9) and (A23)); <4/ is the reactor volume; and 
5 f ^ is the Kronecker symbol: 
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Assigned-Temperature Problem 

In this case the additional partial derivatives required are 
those with respect to m and are as follows: 


z2i 

dm ^ 


i = 1,..., NRS (A153) 


Assigned-Mass-Flow-Rate Problem 

For this problem type {3^/3r} and d^fdT must also be 
computed. They are given by 


= Q_ 

3 in m 2 


(A 154) 


In equation (A 153) the asterisk denotes the reactor inlet state. 
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Appendix B 

Accessing System Clock 

To measure the execution time required by LSENS, the 
user must provide a subprogram, REAL FUNCTION 
SECCPU, which computes the incremental central process- 
ing unit (CPU) time in seconds. This function calls the sys- 
tem clock and is given in figures B.l to B. 8 for several com- 
mon computing systems. If the call to the system clock is not 
available or known, the dummy version of SECCPU given in 
figure B.9 may be used. 


REAL FUNCTION SECCPU(TIME) 

C 

CHARACTERS DATTIM 
C 

REALTIME 

REAL ECPU,ETCPU,ETIME 
C 

CALL DATETM(DATTIM,ECPU,ETIME.ETCPU) 
C 

SECCPU = ECPU - TIME 
C 

RETURN 

C -END OF FUNCTION SECCPU- 

END 

Figure B.2. — Listing of function SECCPU for 
Amdahl 5870 computer and VM operating 
system. 


REAL FUNCTION SECCPU(TIME) 
C 

INTEGER ITIME 
C 

REALTIME 
REAL CPTIME 
C 

CALL CPUTIM(ITIME) 

C 

CPTIME = FLOAT(ITIME)* 1 .0E-03 
SECCPU = CPTIME - TIME 
C 

RETURN 

C- END OF FUNCTION SECCPU 

END 


Figure B.l . — Listing of function SECCPU for 
IBM 370 computer. 


REAL FUNCTION SECCPU(TIME) 
C 

REALTIME 
REAL CPTIME 
C 

CALL CLOCK(CPTIME, 1,1) 

C 

CPTIME = CPTIME* 1 .0E-03 
SECCPU = CPTIME - TIME 
C 

RETURN 

C END OF FUNCTION SECCPU 

END 


Figure B.3. — Listing of function SECCPU for 
Amdahl 5870 computer, UTS operating 
system, and Fujitsu 77 compiler. 





REAL FUNCTION SECCPU(TIME) 

C 

INTEGER ITIME 
C 

REAL TIME 
REAL CPTIME 
C 

INCLUDE (SJPIDEF)’ 

C 

CALL LIB$GETJPI(JPI$_CPUTIM,„ITIME„) 
C 

CPTIME = FLOAT(ITIME)*l,0E-02 
SECCPU = CPTIME - TIME 
C 

RETURN 

C -END OF FUNCTION SECCPU- 

END 


Figure B.4. — Listing of function SECCPU for 
VAX computers. 


REAL FUNCTION SECCPU(TIME) 
C 

REALTIME 
REAL CPTIME 
REAL DUM 
C 

DIMENSION CPTIME(2) 

C 

EXTERNAL f771id 
C 

DUM = ETIME(CPTIME) 

C 

SECCPU = CPTIME(l) - TIME 
C 

RETURN 

C -END OF FUNCTION SECCPU 

END 


Figure B.7. — Listing of function SECCPU for 
Sun SPARCstation 1. 


REAL FUNCTION SECCPU(TIME) 


REAL FUNCTION SECCPU(TIME) 

C 


C 

REALTIME 


INTEGER ITIME 

REAL CPTIME 


C 

C 


REALTIME 

CALL SECOND(CPTIME) 


REAL CPTIME 

c 


C 

SECCPU = CPTIME - TIME 


ITIME = MCLOCK0 

C 


C 

RETURN 


CPTIME = FLOAT(ITJME)* 1 .0E-02 

C- END OF FUNCTION SECCPU 


SECCPU = CPTIME - TIME 

END 


C 


RETURN 

Figure B,5. — Listing of function SECCPU for 

C -END OF FUNCTION SECCPU 

CDC Cyber and Cray computers. 

END 


Figure B.8. — Listing of function SECCPU for 
IBM RISC System/6000. 


REAL FUNCTION SECCPU(TIME) 
C 

REALTIME 
REAL CPTIME 
REAL DUM 


C 


DIMENSION CPTIME(2) 


REAL FUNCTION SECCPU(TIME) 

C 


C 

DUM = ETIME(CPTIME) 


REALTIME 

C 


C 

SECCPU = CPT1ME( I ) - TIME 


SECCPU = 0.0 

C 


C 

RETURN 


RETURN 

C- —END OF FUNCTION SECCPU 


C -END OF FUNCTION SECCPU 

END 


END 


Figure B.6.— Listing of function SECCPU for Figure B. 9.— Listing of dummy function 

Convex C220 minicomputer, Alliant FX/S SECCPU that can be used if call to system 

computer, and IRIS workstations. clock is not available or known. 
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Appendix C 

Code Modifications 


The present version of LSENS has built-in values for the 
following parameters: maximum number of elements (atoms, 
etc.), maximum number of species, maximum number of 
reactions, maximum number of third-body collisional reac- 
tions, maximum number of species with third-body colli- 
sional efficiencies different from unity for any one reaction, 
maximum number of tabular values for the assigned variable 
(pressure or area) and temperature, and maximum number of 
print stations. The necessary modifications to change the 
present values of these quantities are described in this appen- 
dix. Information is also given on changing logical unit num- 
bers and some parameters that control the integration and 
sensitivity analysis computation. 

All of the above quantities are set in the BLOCK DATA 
module. Table C.l lists these variables, describes them, and 
gives their current values. All variables are integers, except 
SMEST, which is a double-precision variable, and TESTNO, 
which is real. Although any quantity may be reset by the 
user, we strongly recommend against changing the current 
values of JDMJAC, JDMOPT, and MESFLG. In particular, 
resetting MESFLG to zero will switch off all error messages 
from subroutine XERRWV (see table 9.1). The user will 
then be unaware of any difficulty experienced by the LSODE 
package, including illegal input. The reason for any prema- 
ture execution termination may also be a mystery. The inte- 
ger JDMOPT controls how the integration is to be continued 
after every solution output. The current value (= 0) indicates 
that the integration is to be continued normally. If JDMOPT 
is set to any nonzero value, LSODE will be reinitialized after 
every printout, which may result in significantly increased 
execution times and a reduction in the accuracy of both the 
kinetics and sensitivity analysis results. The integer 
JDMJAC controls the frequency of Jacobian matrix update 
while performing sensitivity analysis. The current value 
(= 0) means that the Jacobian matrix is to be updated on 
every step. Any nonzero value for JDMJAC will result in the 
matrix being updated only on those steps for which LSODE 
found this update necessary for the kinetics problem. Be- 


cause the accuracy of the sensitivity coefficients is not tested, 
it may deteriorate if this option is used. 

The maximum number of elements NLMAX that make up 
the chemical species can be changed by using table C.2. 
Table C.3 shows how to reset the maximum number of 
(reacting plus inert) species LSMAX that the reaction mecha- 
nism can involve. In addition to the modifications listed in 
this table, if LSMAX is increased, the lengths LRW of the 
real work array RWORK and LIW of the integer work array 
IWORK must be reset in the MAIN program. However, if 
LSMAX is reduced, the current dimensions for the two ar- 
rays need not be reset, although doing so will decrease stor- 
age requirements. These arrays are used for both integration 
of kinetics problems and sensitivity analysis. When sensitiv- 
ity analysis is required, the length of RWORK will have to be 
reset if the maximum number of reactions LRMAX is in- 
creased. 

The minimum length of RWORK (i.e., minimum LRW) 
depends on the number N of ordinary differential equations 
(ODE’s) and the method flag MF (see eq. (9.1) and 
table 9.4). For sensitivity analysis computations the total 
number of sensitivity parameters NDMSEN must also be 
taken into account. The minimum length of IWORK (i.e., 
minimum LIW) depends on N, the corrector iteration tech- 
nique MITER (see table 9.5), and whether sensitivity analy- 
sis is needed. 

For a kinetics-only problem (i.e., no sensitivity analysis) 
the required minimum LRW for each MF is given in table 
C.4. In this table MAXORD is the maximum method order 
to be used and has the default values of 12 for the Adams- 
Moulton method and 5 for the backward differentiation for- 
mula method. The maximum number of ODE’s solved by 
the code is LSMAX + 3. The required minimum LIW is 
given in table C.5 for each MITER. 

The LRW value used in the current version of LSENS is 
the minimum required for MF = 21, the default method. 
Thus, even if LSMAX is not increased, the user may have to 
reset LRW if a different MITER is selected. In addition, if 
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TABLE C.l — USER- ADJUSTABLE VARIABLES IN BLOCK DATA MODULE a 


Variable 

name 

Description 

Current 

value 

JDMJAC 

Switch to specify when Jacobian matrix is to be updated for sensitivity computations. JDMJAC = 0 causes this 
matrix to be computed at every time step. JDMJAC = 1 causes the Jacobian matrix to be computed only when it is 
updated by LSODE. 

0 

JDMOPT 

Switch to specify mode of continuation of integration after every solution printout. JDMOPT = 0 instructs LSODE to 
continue integration normally. JDMOPT = 1 causes LSODE to restart solution after every printout. 

0 

LDAT 

Logical unit number for temporary storage of input data for each individual case 

7 

LREAD 

Logical unit number for problem data file 

5 

LRMAX 

Maximum number of reactions 

250 

LSCR 

Logical unit number for temporary storage of thermodynamic data included in problem data file 

9 

LSMAX 

Maximum number of reacting-plus-inert species 

50 

LTHM 

Logical unit number for standard thermodynamic data file 

4 

LTRAP 

Logical unit number for transport properties data file 

8 

LUNIT 

Logical unit number for (a) error messages from subroutine XERRWV for both kinetics and sensitivity analysis 
computations and (b) information regarding storage and computational work requirements for sensitivity analysis 

6 

LWRITE 

Logical unit number for all output, except the quantities listed for LUNIT 

6 

MESFLG 

Control flag for printing error messages from subroutine XERRWV. MESFLG = 0 tells the routine not to print any 
error message. MESFLG = 1 tells it to print all messages. 

1 

NBLANK 

Identification number to denote no species in reactant or product location in a reaction (used internally) 

52 

NLMAX 

Maximum number of elements 

15 

NPHOTO 

Identification number to denote “reactant” HNU for photochemical reaction (used internally) 

53 

NPMAX 

Maximum number of print stations 

100 

NTBMAX 

Maximum number of tabular values for both the assigned variable (pressure or area) and temperature 

100 

NTHRD 

Identification number to denote third-body species M (used internally) 

51 

SMEST 

In normalizing sensitivity coefficients variable values less than SMEST in magnitude are set equal to SMEST 

10“ 35 

TBRMAX 

Maximum number of third-body collisional reactions 

35 

TBSMAX 

Maximum number of species with third-body collisional efficiencies different from 1.0 for any one reaction 

10 

TESTNO 

Value (essentially minus infinity) to which all print stations and tabular values of assigned variable are initialized 

-10 35 


a All variables are integers, except SMEST, which is a double-precision variable, and TESTNO, which is real. 
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C. Code Modifications 


TABLE C.2. — MODIFICATIONS NEEDED TO 
CHANGE MAXIMUM NUMBER OF 
ELEMENTS (NLMAX) 


1 . Change NLMAX in BLOCK DATA to required value. 

2. Change variable dimensions in the following common 
blocks: 

Common block 

Variable (dimension) 3 

ELMNTS 

ELNAM(NLMAX) 

MISC 

ELNCK NLMAX) 

MATX 

GA(max(LSMAX+ 1 , NLMAX+2), 
max(LSMAX+2, NLMAX+2)), 
GX(max(LSM AX+ 1 , NLMAX+2)) 

SPECES 

ELSP(NLMAX, LSMAX) 


a LSMAX is the maximum number of reacting-plus-inert 
species (see table C.3). 


MF is equal to 14, 15, 24, or 25, the user must set 
IWORK(l) = ML and IWORK(2) = MU in the MAIN pro- 
gram before the call to subroutine SENDDM. Here ML and 
MU are, respectively, the lower and upper half-bandwidths of 
the banded Jacobian matrix. If MITER = 4 (i.e., if MF is 14 
or 24), the user must replace subroutine PEDERV with a rou- 
tine satisfying the requirements described in reference 22. 

If sensitivity analysis is required, only a value of 21 may 
be specified for the method flag. The code assumes a maxi- 
mum method order of five, even if a smaller value is set in 
namelist SOLVER (see section 11.3.9 and table 11.16). The 


array RWORK will require an additional N(6NDMSEN + N 
+ 1) + 2 words for the sensitivity analysis computations. In 
this case the maximum number of ODE’s solved is LSMAX + 2. 
The minimum LRW needed for the kinetics-plus-sensitivity- 
analysis computation is given in table C.4. Here NDMSEN 
is the total number of initial conditions and rate coefficient 
parameters with respect to which sensitivity coefficients are 
to be computed and has a maximum value of LSMAX + 2 + 
3LRMAX. The dimension of the array IWORK must be in- 
creased by at least N + 20, and the minimum LIW value that 
must be set is given in table C.5. 

For either computation (i.e., kinetics only or kinetics plus 
sensitivity) the user must reset the LRW and LIW values 
given in the MAIN program. In addition, the dimensions 
specified in this routine for RWORK and IWORK must be 
changed to reflect the new LRW and LIW. 

The modifications needed to change the maximum number 
of reactions LRMAX are given in table C.6. If LRMAX 
is increased and the sensitivity analysis option is used, LRW 
may have to be increased, as described previously (see 
table C.4). 

The necessary actions to assign new values for the maxi- 
mum number of third-body collisional reactions TBRMAX 
and the maximum number of species with third-body colli- 
sional efficiencies different from unity TBSMAX are listed in 
tables C.7 and C.8, respectively. Table C.9 shows how to 
change the maximum number of tabular values NTBMAX 
for the assigned variable and temperature. Finally, to reset 
the maximum number of print stations NPMAX, table C.10 
may be consulted. 
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TABLE C.3.— MODIFICATIONS NEEDED TO CHANGE MAXIMUM NUMBER OF SPECIES (LSMAX) 


1. Changes in BLOCK DATA 

a. Reset LSMAX to desired maximum number of species. 

b. Reset following three variables to indicated values: 
NTHRD = LSMAX+I 

NBLANK = LSMAX+2 
NPHOTO = LSMAX+3 


2. Change va 

riable dimensions in the following common blocks: 

Common 

block 

Variable (dimension) 3 ’** 

COND 

SIGMA(LSMAX) 

DFDPA 

DFDPJ(LSMAX+2, 3LRMAX) 

GHSC 

GRT(LSMAX), HRT(LSMAX), SR(LSMAX), CPR(LSMAX), DCPR(LSMAX) 

INERT 1 

DISNM(LSMAX) 

MATX 

GA(max(LSMAX+l, NLMAX+2), max(LSMAX+2, NLMAX+2)), GX(max(LSMAX+l, NLMAX+2)) 

PDDTRM 

PDDSIG(LSMAX) 

SAVRAT 

FF(LSMAX+3) 

SENNAM 

SNAMES(2, LSMAX+3) 

SENNOR 

SIVNP(LSMAX+2), YINV(LSMAX+2) 

SENPAR 

SCIV(LSMAX+3 , LSMAX+2), SCRP(LSMAX+3, LRMAX, 3), IDPAR(2, LSMAX+2) 

SENSOL 

DYDY0(LSMAX+2, LSMAX+2), SENSE(LSMAX+3, LRMAX, 3) 

SPCONC 

C(LSMAX) 

SPECES 

EN(LSMAX), ENLN(LSMAX), DELN(LSMAX), ELSP(NLMAX, LSMAX) 

SPEC 1 c 

DSPNM(LSMAX) 

SPEC2 

MW(LSMAX), W(LSMAX), STOICH(LSMAX, LRMAX), OMEGA(LSMAX, LRMAX) 

TCOF 

TC(LSMAX, 7, 2) 

TRAN 

VTC(4, LSMAX, 2), ICV(LSMAX), VCSP(LSMAX, 2) 

3. Change vari 

able dimensions in DIMENSION statements in the following routines: 

Routine 

Variable (dimension)** 

MAIN 

Y0(LSMAX+3), ATOL(LSMAX+3) 

GAUSS 

COEFX(LSMAX+ 1 ) 

HETRAN 

DLVC(LSMAX) 

KINP 

C(LSMAX) 

OUT2 

PRC(LSMAX) 

PEDERV 

PBBSIG(LSMAX), PGSIG(LSMAX), PM2SIG(LSMAX), PSISIG(LSMAX), PS2SIG(LSMAX) 

RXNTAB 

NRIMP(LSMAX, LRMAX), OMOUT(LSMAX, LRMAX) 

WSOUT 

EN(LSMAX), FMOUT(4, LSMAX) 

WSR 

ES(LSMAX), DLSIG(LSMAX), SIGLN(LSMAX), TZ(LSMAX+1) 

SNSTAB 

NRIMP(LSMAX+3, LRMAX, 3) 

4. Rewrite one EQUIVALENCE statement in subroutine KINP as follows: 

EQUIVALENCE (EFFM, DSPNM(LSMAX+1), (BLANK, DSPNM(LSMAX+2)), (HNU, DSPNM(LSMAX+3)) 


a NLMAX is the maximum number of elements (see table C.2). 

^LRMAX is the maximum number of reactions (see table C.6). 

In subroutines KINP and OUT1 the dimension of DSPNM in common block SPEC1 must be set equal to LSMAX+3 
and not that given in the table. 



TABLE C4— MINIMUM LENGTH REQUIRED BY REAL WORK ARRAY 
RWORK (i.e., MINIMUM LRW) 


Problem type 

Method flag, 
MF 

Minimum length required for RWORK, 
minimum LRW 

Kinetics only 

10, 20 

11, 12, 21,22 

13, 23 

14, 15, 24, 25 a 

20 + N(MAXORD + 4) 

22 + N(MAXORD + N + 4) 

22 + N(MAXORD + 5) 

22 + N(MAXORD + 2 ML + MU + 5) 

Kinetics and 

sensitivity 

analysis 6 

21 

24 + N(6NDMSEN + 2N + 10) 


a ML and MU arc, respectively, the lower and upper half-bandwidths of the 
banded Jacobian matrix. If MF = 14 or 24 is chosen, subroutine PEDERV 
must be replaced; otherwise, numerical instability may result. 
b Only MF = 21 is allowed. 


TABLE C.5.— MINIMUM LENGTH 
REQUIRED BY INTEGER WORK 
ARRAY 1WORK (i.e., 
MINIMUM LIW) 


Problem type 

Iteration 

method, 

MITER 3 

Minimum length 
required for 
IWORK, 
minimum 
LIW 

Kinetics only 

0, 3 

20 


1,2, 4,5 

20 + N 

Kinetics and 

1 

40 + 2N 

sensitivity 



analysis 6 




a See table 9.5. 

b Only MITER = 1 is allowed. 




TABLE C.6.— MODIFICATIONS NEEDED TO CHANGE MAXIMUM 
NUMBER OF REACTIONS (LRMAX) 


1. Change LRMAX in BLOCK DATA to required value. 

2. Change variable dimensions in the following common blocks: 

Common 

block 

Variable (dimension) 3 

DFDPA 

KOUT2 

RATLOG 

REAC2 

RRAT 

SENPAR 

SENSOL 
SPEC 2 
STCS 
ZERCON 

DFDPJ(LSMAX+2, 3LRMAX) 

DELH(LRMAX ) 

DAFLOG(LRMAX) 

LSR(4, LRMAX), XX(LRMAX), DPX(2, LRMAX), 
RATE(LRMAX), BRATE(LRMAX), LRTYPE( LRMAX) 
A(LRMAX), N(LRMAX), EACT(LRMAX), NUM(LRMAX) 
SCRP(LSMAX+3, LRMAX, 3), DTRDRP(2, LRMAX, 3), 
NREAC(LRMAX) 

SENSE(LSMAX+3, LRMAX, 3) 

STOIC(LSMAX, LRMAX), OMEGA(LSMAX, LRMAX) 
NSTOIC(4, LRMAX), NSPRP(2, LRMAX) 

FBRATE(2, LRMAX) 

3. Change variable dimensions in DIMENSION statements in the following 
subroutines: 

Subroutine 

Variable (dimension) 3 

OUT2 

RXNTAB 

SENSIN 

SNSTAB 

PRX(LRMAX), EQUBL(LRMAX) 

NRIMP(LSMAX, LRMAX), OMOUT(LSMAX, LRMAX) 
RXNUM(LRMAX) 

NRIMPfLSMAX+3, LRMAX, 3) 


a LSMAX is the maximum number of reacting-plus-inert species (see 
table C.3). 


TABLE C.7. — MODIFICATIONS NEEDED TO CHANGE MAXIMUM 
NUMBER OF THIRD-BODY REACTIONS (TBRMAX) 


1 . Change TBRMAX in BLOCK DATA to required value. 

2. Change variable dimensions in the following common blocks: 

Common block 

Variable (dimension) 3 

REAC2 

MM(TBRMAX), LR3RD(TBRMAX), NS3RD(TBRMAX), 
I3RD(TBSMAX, TBRMAX) 

RRAT 

M(TBSMAX, TBRMAX) 

SPEC1 

TBSPNM(TBSMAX, TBRMAX) 


a TBSMAX is the maximum number of third-body species with efficiencies 
different from unity (see table C.8). 




TABLE C.8.— MODIFICATIONS NEEDED TO CHANGE 
MAXIMUM NUMBER OF SPECIES WITH THIRD- 
BODY EFFICIENCIES DIFFERENT FROM 
UNITY (TBSMAX) 


I. Change TBSMAX in BLOCK DATA to required value. 

2. Change variable dimensions in the following common blocks: 

Common block 

Variable (dimension)* 

REAC2 

I3RD(TBSMAX, TBRMAX) 

RRAT 

M(TBSMAX, TBRMAX) 

SPEC1 

TBSPNM(TBSMAX, TBRMAX) 


*TBRMAX is the maximum number of third-body reactions (see 
table C.7). 


TABLE C.9. — MODIFICATIONS NEEDED TO CHANGE MAXIMUM NUMBER OF 
TABULAR VALUES FOR ASSIGNED VARIABLE (PRESSURE OR AREA) 
AND TEMPERATURE (NTBMAX) 


1. Change NTBMAX in BLOCK DATA to required value. 

2. Change variable dimensions in the following common blocks: 

Common 

Variable (dimension) 

Alternative name (dimension), if any, 

block 


for variable and subprograms where 
alternative name is used 

CUB AS V 

CUBX(NTBMAX) 

CUBY(NTBMAX) 

CUBM(NTBMAX) 


CUBTMP 

CUBXT(NTBMAX) 

CUBYT(NTBMAX) 

CUBMT(NTBMAX) 


SAVTMP 

XTB(NTBMAX) 

DUMST1 (NTBMAX) in MAIN 


TTB(NTBMAX) 

DUMST2(NTBMAX) in MAIN 


TMPTB(NTBMAX) 

DUMST3(NTB MAX) in MAIN 

SAVVAR 

CXTB(NTBMAX) 

DUMSVl (NTBMAX) in MAIN and OUT1 


CATB (NTBMAX) 

DUMSV2(NTBMAX) in MAIN and OUT1 


CXTTB(NTBMAX) 

DUMS V 3(NTBMAX) in MAIN and OUT1 


CTMPTB(NTBMAX) 

DUMSV4(NTBMAX) in MAIN and OUT1 

XVSA2 

XTB (NTBMAX) 

XTBSAV(NTBMAX) in KINP 


ATB (NTBMAX) 

ATBSAV(NTBMAX) in KINP 

XVST2 

XTTB(NTBMAX) 

XTTBSV(NTBMAX) in TINP 


TMPTB(NTBMAX) 

TTBSAV(NTBMAX) in TINP 

3. Change variable dimensions in DIMENSION statements in the following subroutines: 

Subroutine 


Variable (dimension) 

CUBS 

X(NTBMAX), Y(NTBMAX), CUBX(NTBMAX), CUBY(NTBMAX), 
CUBM(NTBMAX) 

KINP 

XTB(NTBMAX), TTB(NTBMAX), ATB(NTBMAX) 

SPLINE 

X(NTBMAX), Y(NTBMAX). M(NTBMAX), SPS(NTBMAX), 


SPT(NTBMAX). U(NTBMAX), V(NTBMAX), TX(NTBMAX) 
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TABLE CIO— MODIFICATIONS NEEDED TO CHANGE MAXIMUM 
NUMBER OF PRINT STATIONS (NPMAX) 


1. Change NPMAX in BLOCK DATA to desired value. 

2. Change variable dimensions in the following common blocks: 

Common 

block 

Variable (dimension) 

Alternative name (dimension) for variable 
and subprograms where alternative 
name is used 

PRIN 

PRIN2 

SAVTMP 

PRINT(NPMAX) 

APRINT(NPMAX) 

PRINT(NPMAX) 

TPRINT(NPMAX) 

CPRINT(NPMAX) in KINP and TINP 
DUMP21 (NPMAX) in MAIN 
DUMP22(NPMAX) in MAIN 
DUMST6(NPMAX) in MAIN 
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